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1.  INTRODUCTION 


This  Programmer’s  Manual  is  one  of  the  manuals  documenting  the  Automated  STRuctural  Opti¬ 
mization  System  (ASTROS).  The  other  three  are  the  Theoretical  Manual,  the  User’s  Manual  and  the 
Applications  Manual.  The  Theoretical  and  Applications  Manual  indicate  the  range  of  capabilities  of  the 
ASTROS  system  while  the  User’s  Manual  provides  a  complete  description  of  the  user  interface  to  the 
system.  The  Programmer’s  Manual  gives  the  detailed  description  of  ASTROS  software.  It  describes  the 
system  in  terms  of  its  software  components,  documents  the  procedure  for  installing  ASTROS  on  different 
host  machines  and  provides  detailed  documentation  of  the  application  and  utility  modules  that  comprise 
the  procedure.  In  addition,  the  data  structures  of  the  database  entities  are  presented  in  detail.  This 
tngnnal  is  intended  to  provide  the  system  administrator  with  a  guide  to  the  existing  software  and  the 
researcher  with  sufficient  information  to  add  application  modules  or  otherwise  manipulate  the  data 
generated  by  the  ASTROS  system.  Using  standard  ASTROS  features  does  not  require  a  familiarity  with 
the  information  contained  in  this  manual  except,  perhaps,  for  the  entity  documentation,  which  is  useful 
when  additional  database  entities  are  to  be  viewed. 

This  document,  while  useful  to  the  advanced  engineering  user,  is  directed  toward  the  system 
administrator  or  code  developer.  This  is  the  individual  referred  to  by  the  term  user  unless  otherwise 
indicated.  The  Programmer’s  Manual  is  structured  in  this  way  because  all  the  information  needed  by  the 
engineering  user  is  contained  as  a  subset  of  that  needed  by  the  system  administrator.  As  a  consequence, 
however,  the  manual  is  not  as  simple  for  the  analyst  as  might  be  desired.  It  is  anticipated  that  the 
advanced  application  user  will  need  to  sift  through  the  module  documentation  and  entity  documentation 
to  extract  the  information  needed  to  modify  the  ASTROS  execution  path  or  to  insert  additional  modules 
for  performing  alternative  computations,  printing  additional  results,  writing  data  in  alternative  formats 
or  other  advanced  features  that  may  be  performed. 

As  an  introduction  to  the  ASTROS  system.  Section  2  contains  a  description  of  the  software 
structure  of  ASTROS,  both  to  provide  a  resource  for  the  system  administrator  and  to  be  a  road  map  for 
the  application  user  in  identifying  specific  modules  relevant  to  the  task  of  interest.  Section  2  attempts  to 
introduce  the  \aser  to  the  totality  of  ASTROS  source  code  and  their  interrelationships  so  that  subsequent 
reading  will  be  more  readily  interpretable:  in  essence.  Section  2  provides  a  nomenclature  section  enabling 
the  reader  to  identify  (with  the  inevitable  exceptions)  the  major  unit  (mod\ile)  or  fimctional  library  to 
which  a  particular  program  belongs.  This  section  provides  a  framework  for  subsequent  sections  in  the 
Programmer’s  Manual. 
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Section  3  is  devoted  to  the  installation  of  the  ASTROS  system  on  various  host  computers.  The 
steps  involved  in  installing  the  system  are  given,  followed  by  detailed  docximentation  of  all  the  machine 
and  installation  dependent  code.  Sufficient  detail  is  given  to  allow  someone  famihar  with  the  target  host 
system  to  write  a  set  of  machine-dependent  code  for  that  machine  or  site.  This  documentation  is  followed 
by  the  description  of  the  System  Generation  Process  (SYSGEN)  and  its  inputs.  These  inputs,  along  with 
the  SYSGEN  program,  define  the  system  database  which,  in  turn,  defines  system  data  to  the  ASTROS 
executive.  It  is  these  inputs  which  the  researcher  may  wish  to  modify  to  define  a  new  module,  define  a 
new  set  of  inputs  or  make  other  advanced  modifications  of  the  system.  A  brief  presentation  of  the  order  of 
the  operations  that  follow  preparation  of  the  machine  dependent  hbrary  is  given  to  complete  an  installa¬ 
tion  of  the  system. 

Sections  4  through  8  contain  the  formal  documentation  of  the  ASTROS  modules.  Section  4 
documents  those  portions  of  the  code  that  are  considered  to  be  at  the  system  level.  This  means  that  the 
user  need  not  be  aware  of  their  existence  but  they  are  important  in  the  overall  system  architectmre. 
Further,  they  perform  many  tasks  of  which  the  user  may  want  to  be  aware  if  any  system  modifications 
are  to  be  made.  Sections  6  through  8  document  the  utilities  that  are  associated  with  the  ASTROS 
application  modules,  matrix  operations  and  the  database.  These  sections  are  the  most  important  from  the 
view  of  the  advanced  researcher/user  in  that  these  are  the  software  tools  from  which  additional  capabfii- 
ties  can  be  put  together  with  reasonable  rapidity.  In  each  case,  the  executive  (MAPOL)  and  application 
interface  is  fully  defined  and  the  algorithm  of  the  utility  is  outlined. 

Section  9  contains  the  documentation  of  the  data  structures  on  the  CADDB  database  that  are 
used  by  the  ASTROS  system.  The  contents  and  structure  of  each  database  entity  are  given  along  with  an 
indication  of  the  module  that  generates  the  data  and  which  modules  use  the  data.  For  matrix  entities, 
the  relevant  section  of  the  Theoretical  Manual  is  also  referenced  since  the  entity  contents  are  more 
clearly  xmderstood  in  the  content  of  the  equations  that  are  highlighted  there. 

Section  10  contains  a  presentation  of  notes  for  the  ASTROS  application  programmer.  It  is  felt 
that  the  ASTROS  system  has  been  designed  with  sufficient  flexibility  that  the  additional  features  or 
minor  enhancements  are  desired.  Section  10,  therefore,  attempts  to  address  some  issues  involved  in 
writing  an  ASTROS  module.  Rules  and  guidelines  are  given  which  wiU  help  the  programmer  avoid 
comphcations  arising  from  the  interface  of  the  new  module  and  appfication  utilities  are  also  given. 
Particular  emphasis  is  placed  on  the  memory  management  utihties  and  the  database  utilities  since  these 
require  a  more  sophisticated  interface  than  the  simple  appfication  utilities. 

A  standard  documentation  format  has  been  adopted  for  the  modules  that  are  described  in  Section 
3  through  8.  Figure  1  illustrates  this  format  and  provides  a  key  for  identifying  the  data  that  are  given  for 
each  module.  While  this  format  is  brief,  enough  information  is  given  for  the  user  to  identify  the  principal 
action  of  the  module  and  the  role  it  plays  in  the  standard  ASTROS  execution.  The  utility  modules  are 
documented  to  the  extent  necessary  for  an  appfication  programmer  to  use  the  utility  in  any  new  code  to 
be  inserted  in  the  system. 


2 


<  module  type>  Module:  <naiiie> 

Entry  Point:  <FORTRAN  calling  list  for  inodule> 

PURPOSE: 

<one  or  two  sentence  description> 

MAPOL  Calling  Sequence: 

<Executive  system  access  method> 

Application  Calling  Sequence: 

<FORTRAN  call  followed  by  input  description> 

Method: 

<Description  of  the  module’s  action> 

Design  Requirements: 

<Indicates  what  the  module  expects  to  have  completed  in  the  context  of  the  standard 
sequence> 

Error  Conditions: 

<Brief  description  of  some  error  conditions  that  are  trapped  by  the  module> 

Figure  1.  Module  Documentation  Format 
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2.  ASTROS  SOFTWARE  DESCRIPTION 

ASTROS  is  a  software  system  made  up  of  two  separate  executable  programs  comprising  over 
1500  independently  addressable  code  segments  containing  approximately  300,000  lines  of  FORTRAN. 
While  this  Programmer’s  manual  is  devoted  primarily  to  the  detailed  documentation  to  the  separate 
modules  and  subroutines  of  the  ASTROS  system,  an  overview  of  that  system  is  necessary  to  xmderstand 
how  the  individual  pieces  fit  together.  This  section  introduces  the  ASTROS  system  and  describes  the 
software  structure  of  ASTROS  in  terms  of  its  major  code  blocks.  Both  the  system  generation  program, 
SYSGEN,  and  the  main  program,  ASTROS,  are  described  and  their  interrelationships  are  illustrated. 
This  section  provides  a  resource  for  the  system  administrator  and  a  road  map  for  the  apphcation  pro¬ 
grammer  to  identify  the  section  documenting  modules  relevant  to  the  task  of  interest.  This  section  also 
provides  a  fi-amework  to  direct  the  subsequent  sections  in  the  Programmer’s  Manual. 

In  the  context  of  the  Programmer’s  Manual,  the  structure  of  the  ASTROS  system  refers  to  the 
interrelationships  among  the  major  code  blocks.  Typically,  an  analysis  of  the  software  associated  with  an 
individual  code  segment  will  indicate  the  nature  of  the  task  being  performed  and  provide  mformation  on 
the  mechanisms  by  which  intramodular  communication  takes  place.  The  larger  picture,  in  which  the 
intermodular  requirements  of  a  particular  code  segment  becomes  clear,  is  more  difficult  to  grasp.  It  is 
that  picture  which  this  section  attempts  to  provide. 


The  magnitude  of  the  ASTROS  system  requires  that  the  code  segments  be  grouped  into  abstract 
collections  of  code  such  as  utility  modules  and  the  database  in  order  to  be  understood.  While  necessary, 
these  abstract  collections  can  also  obscure  the  picture  of  the  system  since  a  great  deal  of  the  detail  is 
necessarily  lost.  Nonetheless,  since  a  discussion  of  each  individual  code  segment  is  not  possible,  a  set  of 
code  blocks  has  been  defined  for  the  purpose  of  writing  the  Programmer’s  Manual.  Naturally,  there  are 
many  ways  iu  which  the  code  segments  could  be  grouped  to  aid  the  user  in  imderstanding  the  code 
segments  and  their  interactions.  For  the  Programmer’s  Manual,  the  code  is  grouped  in  a  hierarchical 
manner  by  fiinction;  that  is,  code  segments  that  perform  similar  tasks  at  a  similar  level  (relative  to  the 
executive  system)  are  grouped  together.  Some  segments  of  the  code,  of  course,  do  not  fit  clearly  into  this 
sort  of  functional  abstraction.  Their  role  is  such  that  they  could  lie  in  more  than  one  group  or  really  don’t 
belong  to  any  group  that  lias  been  defined.  These  exceptions  complicate  the  issue  but  do  not  destroy  the 
utility  of  the  functional  breakdown  of  the  code.  When  a  module  could  be  documented  with  more  than  one 


code  group,  this  fact  is  noted  in  the  appropriate  manual  sections. 
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2.1.  THE  ASTROS  SYSTEM 


The  highest  level  of  abstraction  is  illustrated  in  Figure  2,  which  presents  the  two  executable 
images  that  comprise  the  ASTROS  system,  their  inputs,  outputs,  and  interrelationships.  Referring  to  the 
figure,  each  of  the  illustrated  components  is  briefly  described  m  the  following  sections. 

2.1.1.  SYSGEN  Components 

The  SYSGEN  program  is  a  stand-alone  executable  program  that  is  used  to  define  ASTROS 
system  parameters.  The  use  of  an  executable  program  that  is  directed  by  a  set  of  inputs  was  adopted  to 
provide  a  simple  mechanism  to  expand  the  capabilities  of  the  ASTROS  procedure.  The  inputs,  outputs, 
and  use  of  this  very  important  feature  of  the  ASTROS  architecture  are  fully  documented  in  Section  3.2. 
The  SYSGEN  program  consists  of  five  items  indicated  by  the  numbered  boxes  in  Figure  2.  Each  of  these 
is  briefly  discussed  below: 

1.  The  SYSGEN  INPUTS  consist  of  a  set  of  files  that  define  certain  system  level  data  that  is  written 
by  SYSGEN  to  the  system  database,  SYSDB. 

2.  SYSGEN  is  an  executable  program  that  reads  the  SYSGEN  INPUTS  and  creates  a  set  of 
database  entities  on  SYSDB  that  provide  data  to  the  ASTROS  executive  and  high  level 
engineering  modules. 

3.  The  SYSTEM  DATABASE,  SYSDB,  consists  of  an  index  file,  SYSDBIX,  and  (t3rpically)  a  single 
data  file,  SYSDBOl.  The  SYSGEN  program  creates  and  loads  database  entities  onto  the  system 
database  which  defines: 

a.  The  set  of  modules  which  can  be  addressed  through  the  MAPOL  language 

b.  The  set  of  relational  schemata  for  all  relations  declared  in  the  MAPOL  sequence 

c.  The  set  of  input  Bulk  Data  entries 

d.  The  error  message  texts  for  most  nm  time  error  messages 

e.  The  standard  MAPOL  sequence  to  direct  the  execution  of  the  ASTROS 

4.  XQDRIV  is  a  FORTRAN  subroutine  written  by  SYSGEN  that  must  be  compiled  and  linked  into 
the  ASTROS  executable  during  the  generation  of  the  ASTROS  executable  image.  It  is  the 
XQDRIV  subroutine  that  forms  the  FORTRAN  link  between  the  MAPOL  language  and  the 
application/utihty  modules. 

5.  The  SYSGEN  OUTPUT  FILE  is  a  listing  generated  by  SYSGEN  that  echoes  all  the  data  stored 
on  the  system  database.  As  such,  it  provides  a  resource  for  the  apphcation  user  and  the  system 
administrator  documenting  the  current  ASTROS  system.  Since  this  file  represents  what  is,  by 
definition,  the  ASTROS  program,  any  problems  that  arise  or  questions  in  the  documentation 
should  be  checked  against  the  data  in  this  file.  If  any  discrepancies  exist,  either  the  documen¬ 
tation  is  in  error  or  the  SYSGEN  inputs  are  in  error.  In  any  case,  the  ASTROS  program  is 
directed  by  the  SYSGEN  data. 
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2.1.2.  ASTROS  Components 


As  illustrated  in  Figure  2,  the  XQDRiv  subroutine  and  SYSDB  are  also  part  of  the  ASTROS 
program.  The  XQDRiv  subroutine  is  needed  to  generate  the  executable  image  and  the  SYSDB  files  MUST 
be  available  on  a  read-only  basis  by  the  ASTROS  program  whenever  an  ASTROS  job  is  run.  The  ASTROS 
program  is  comprised  of  the  following: 

1.  XQDRIV  is  a  FORTRAN  subroutine  written  by  SYSGEN  that  must  be  compiled  and  linked  into 
the  ASTROS  executable  during  the  generation  of  the  ASTROS  executable  image.  It  is  the 
XQDRIV  subroutine  that  forms  the  FORTRAN  link  between  the  MAPOL  language  and  the 
application/utility  modules. 

2.  The  SYSTEM  DATABASE,  SYSDB,  contains  database  entities  which  define  sets  of  data 
establishing  the  extent  of  some  of  the  capabilities  of  the  ASTROS  program.  ASTROS  requires 
these  files  on  a  read-only  basis  for  every  execution  of  the  system. 

3.  The  ASTROS  program  is  the  main  executable  image  associated  with  the  ASTROS  procedure.  It 
is  comprised  of  aU  the  executive,  database,  utihty,  and  engineering  application  modules  that  are 
needed  to  perform  the  automated  multidisciplinary  optimization  tasks. 

4.  The  INPUT  STREAM  is  the  user’s  input  file  containing  the  directives  to  execute  the  ASTROS 
program.  The  User’s  Manual  is  devoted  to  its  documentation. 

5.  The  OUTPUT  FILE  contains  the  data  written  to  the  user’s  output  file  containing  those  results 
of  the  ASTROS  execution  that  were  requested  to  be  printed  or  that  are  printed  by  default. 

6.  The  RUN-TIME  DATABASE  consists  of  one  index  file  and  one  or  more  data  files  (called, 
respectively,  RUNDBIX,  and  RUNDBOl,  02,  etc.,  in  Figure  2)  that  contain  the  database 
generated  at  run  time  by  ASTROS.  Assuming  an  execution  based  on  the  standard  MAPOL 
sequence,  the  run-time  database  will  contain  some  or  all  of  the  entities  that  are  dociimented  in 
Section  9  of  this  manual.  The  application  user  can  direct  whether  this  database  is  to  be  saved 
or  deleted  on  termination  of  the  execution.  The  Interactive  CADDB  Environment  (ICE) 
(AFWAL-TR-88-3060,  August  1988)  can  be  used  to  view  these  data,  prepare  reports  or  port  the 
data  into  other  apphcations. 
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2.2.  MAJOR  FUNCTIONAL  CODE  BLOCKS 


Figure  3  presents  a  grouping  of  source  code  blocks  within  the  ASTROS  system.  This  grouping  is 
functional  in  that  code  related  to  the  performance  of  one  task  or  a  series  of  tasks  at  the  same  level 
relative  to  the  executive  system  are  grouped  together.  According  to  this  breakdown,  there  are  seven 
major  blocks  of  code  within  ASTROS  executable  programs.  The  SYSGEN  program  has  no  executive 
system  and  is  directed  by  a  simple  FORTRAN  driver  called  SYSGEN.  The  ASTROS  system,  on  the  other 
hand,  has  a  highly  developed  executive  system  that  comprises  this  major  ASTROS  code  block.  Also 
shown  are  the  five  groups  of  routines  which  are  used  by  the  SYSGEN  and  ASTROS  programs. 

The  naming  conventions  used  within  each  code  block  are  worthy  of  some  discussion  since  they  are 
useful  in  identifying  an  unknown  routine  in  a  piece  of  ASTROS  software.  Whenever  possible,  a  set  of 
consistent,  meaningfiil  mnemonics  was  adopted  to  identify  groups  of  code  that  belong  together,  either 
functionally  or  logically.  Where  such  conventions  have  been  adopted,  they  are  indicated  in  the  discussion 
of  the  code  block.  One  complication  to  such  conventions  is  the  use  of  existing  source  code  as  a  resource  for 
the  ASTROS  program.  When  major  code  units  were  used  from  existing  software,  the  convention  was  not 
typically  enforced.  As  a  result,  there  are  exceptions  to  the  nomenclatures  adopted  in  some  of  the  source 
code  blocks  presented  in  this  section. 

Each  of  the  source  code  blocks  is  now  briefly  discussed  by  reference  to  the  name  assigned  to  it  in 
Figure  3  anH  its  related  Programmer’s  Manual  section  is  indicated. 

1.  SYSGEN  is  a  very  small  code  block  containing  the  SYSGEN  driver  (SYSGEN),  a  set  of  four 
output  routines  (xxxOUT)  to  print  the  SYSGEN  output  file  and  five  routine  (TlMxaot)  that 
compute  the  timing  constants  for  the  large  matrix  utilities.  The  SYSGEN  program  has  a  single 
execution  path  which  is  documented  in  Section  3.2. 

2 .  The  ASTROS  executive  is  the  code  block  containing  the  ASTROS  main  driver  program,  ASTROS, 
and  the  ASTROS  executive  system  software.  The  executive  system  is  embodied  in  the  routines 
beginning  with  the  mnemonics  XQxxxx.  In  addition  to  the  pure  executive  system  routines,  the 
executive  initialization  routines  for  the  database  (DBINIT)  and  the  memory  manager  (mminit) 
are  also  located  in  this  code  block.  Finally,  the  general  initialization  routine  PREPAS  and  the 
MAPOL  compiler  software  are  considered,  for  the  purposes  of  the  Programmer’s  Manual,  to  be 
part  of  the  executive  system.  These  routines  are  documented  in  Section  5. 

3.  The  DATABASE  code  block  contains  all  the  software  related  to  the  application  interface  to  the 
database  and  memory  management  systems  for  the  ASTROS  procedure.  This  software  is  further 
subdivided  into  five  groups  of  code  that  represent  the  application  interface  to  the  database  and 
memory  manager.  These  groups  are: 

a.  The  General  Utilities  that  comprise  the  database  application  interface  applicable  to  all 
database  entity  types.  These  routines  are  denoted  by  the  mnemonics  DBaonnc  and  are 
documented  in  Section  8.2. 

b.  The  Memory  Management  Utilities  that  comprise  the  application  interface  to  the  ASTROS 
dynamic  memory  manager.  These  routines  are  denoted  by  the  mnemonics  MMxaoK  and  are 
dociunented  in  Section  8.3. 
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c.  The  Matrix  Utilities  that  comprise  the  database  application  interface  appUcable  to  matrix 

entities.  These  routines  are  denoted  by  the  mnemonics  MXxaixx  and  are  documented  in 
Section  8.4. 

d.  The  Relation  Utilities  that  comprise  the  database  application  interface  applicable  to 
relational  entities.  These  routines  are  denoted  by  the  mnemonics  R£xxxx  and  are  docu¬ 
mented  in  Section  8.5. 

e.  The  Unstructured  Utilities  that  comprise  the  database  application  interface  applicable  to 
unstructured  entities.  These  routines  are  denoted  by  the  mnemonics  UNxaaas  and  are 
documented  in  Section  8.6. 

4.  The  MACHINE  DEPENDENT  code  block  contains  all  the  software  in  the  ASTROS  system  that 
has  been  designated  machine  dependent.  This  software  supplies  the  interface  between  the  host 
computer  and  the  ASTROS  system.  It  is  further  subdivided  into  two  groups  of  code: 

a.  The  General  Utihties,  comprising  the  machine  dependent  code  used  throughout  the  AS¬ 
TROS  system.  These  routines  are  denoted  by  the  mnemonics  xxxxxx  and  are  documented 
in  Section  3.1.1. 

b.  The  Database  Utilities,  comprising  the  database  machine  dependent  code  used  primarily 
by  the  database  software.  These  routines  are  denoted  by  the  mnemonics  dbmd»c  and  are 
documented  in  Section  3.1.2. 

5.  The  UTILITIES  code  block  contains  all  the  machine  independent  application  utilities  developed 
for  the  ASTROS  system.  This  software  is  a  suite  of  functions  that  are  useful  in  many  places  in 
the  code.  They  have  therefore  been  formalized  to  the  extent  that  they  may  be  used  by  any 
ASTROS  application  routine.  The  majority  of  these  routines  are  denoted  by  the  mnemonics 
UTxxxae  with  exceptions  corresponding  to  those  in-core  utilities  that  came  from  COSMIC/NAS- 
TRAN.  These  are  documented  in  Section  6. 

6.  The  LARGE  MATRIX  UTILITIES  code  block  contains  the  utilities  developed  for  the  ASTROS 
system  to  operate  on  large  matrices  stored  on  the  ASTROS  database  (rather  than  matrices 
stored  m  memory).  This  software  comprises  a  suite  of  matrix  operations  that  have  been 
formalized  to  the  extent  that  they  may  be  used  by  any  ASTROS  application  routine  and  by  the 
ASTROS  executive  system.  There  is  no  consistent  naming  convention  for  these  routines  since 

they  have  been  derived  from  their  COSMIC/NASTRAN  counterparts.  The  utilities  are  docu- 
merited  in  Section  7. 

7.  The  APPLICATION  MODULES  code  block  is  the  largest  code  block  within  ASTROS.  It  contains 
the  engineering  and  application  modules  that  support  the  analysis  and  optimization  features 
of  the  ASTROS  system.  Each  of  these  modules  has  been  designed  to  be  independent  of  the  other 
appUcation  modules  to  the  maximum  extent  possible.  TVpicaUy,  consistent  naming  conventions 
have  been  used  for  routines  within  each  module.  Because  of  the  disparate  code  resources  that 
were  used  m  the  development  of  ASTROS,  however,  no  globally  consistent  naming  convention 
was  adopted.  Section  5  documents  each  of  the  modules  in  the  application  hbraiy. 
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2.3.  CODE  COMMON  TO  ASTROS  AND  SYSGEN 

Since  some  machines  require  or  can  take  advantage  of  an  explicit  knowledge  of  which  routines 
are  needed  to  create  an  executable  image,  this  section  attempts  to  mdicate  which  po^ons  of  the  source 
code  blocks  (as  grouped  in  Figure  3)  are  utilized  within  the  SYSGEN  program.  With  the  exception  of  th 
STOGEN  cod.  bbek  =11  the  ffluBtrated  code  blocks  are  used  by  the  ^TOOS  program 
blocks  that  are  needed,  in  whole,  or  in  part,  by  SYSGEN  are  (1)  the  SYSGEN  code,  (2)  the  DATABASE 
code,  (3)  parts  of  the  MACHINE  DEPENDENT  code,  (4)  some  of  the  UTILITIES  and  (5)  parts  of  the 

ASTROS  EXECUTIVE. 

Rather  than  write  and  maintain  separate  code  blocks  to  perform  similar  ^ctions,  SYSGEN 
makes  use  of  the  suite  of  general  utilities  in  the  UTILITIES  CODE  BLOCK  The  machme  dependent  code 
block  is  also  sharod  between  ASTROS  and  SYSGEN. 

One  of  the  tasks  of  SYSGEN  is  to  compile  and  store  the  standard  executive  sequence  (written  m 
the  MAPOL  language)  onto  the  system  database.  Therefore,  the  SYSGEN 

^St^EXECOTI^  code  block  to  supply  the  MAPOL  compiler.  In  addition,  the  SYSGEN  driver  must 
perform  the  executive  ftmetions  to  mitiaUre  the  memey^ger  tmd  the  ** 

bminit  and  rBlMlT  routines  from  the  ASTROS  EXECUTIVE  code  block  are  also  used  by  SYSGEN. 
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3.  SYSTEM  INSTALLATION 


A  software  system  of  the  magnitude  of  ASTROS  requires  a  formal  installation  of  the  system  on 
each  host  computer.  For  ASTROS,  the  installation  process  can  be  broken  into  three  distinct  phases.  In 
the  first  phase,  the  ASTROS/host  interface  is  defined  and  the  proper  machine  dependent  code  is  written 
to  create  that  interface.  The  second  phase  involves  the  generation  of  the  executable  image  of  the  SYS- 
GEN  program  and  its  execution.  Finally,  the  ASTROS  executable  image  is  generated  using  the  outputs 
from  the  SYSGEN  program.  The  purpose  of  this  section  is  to  document  all  the  machine  dependent  code  in 
a  generic  manner  and  to  indicate  which  parameters  and  routines  are  most  likely  to  be  site  dependent  and 
which  are  truly  machine  dependent.  In  the  typical  case,  the  system  manager  at  each  facility  wiU  be  given 
the  machine  dependent  library  for  the  host  system  that  is  to  be  used.  For  completeness,  however, 
sufficient  detail  is  presented  to  allow  someone  familiar  with  the  host  system  to  write  a  new  set  of 
machine  dependent  code. 

Following  the  formal  documentation  of  the  machine  dependent  interface  is  a  discussion  of  the 
SYSGEN  program  and  its  inputs.  The  SYSGEN  program  is  important  in  that  it  provides  the  advanced 
analyst/user  with  a  mechanism  to  add  features  to  the  system.  It  is  also  important  for  system  installation 
in  that  part  of  its  output  is  required  before  the  executable  image  of  the  ASTROS  procedure  can  be 
generated.  Again,  in  the  typical  case  the  user  will  be  given  a  proper  set  of  SYSGEN  outputs  but  the 
utility  of  SYSGEN  in  increasing  the  capabilities  of  the  system  makes  its  complete  documentation  very 
useful  to  the  majority  of  ASTROS  users.  Finally,  a  brief  section  is  included  to  present  the  total  ASTROS 
installation  in  a  step  by  step  manner  to  give  an  overall  view  of  the  process. 

The  information  presented  in  these  sections  serves  as  a  guide  to  the  installation  of  ASTROS  on 
alternative  host  machines,  but  the  nature  of  the  machine  dependencies  make  it  impossible  to  anticipate 
aU  contingencies  that  may  arise.  The  installation  of  the  ASTROS  procedure  on  a  new  host  computer  can 
therefore  be  a  complex  task  despite  the  relatively  small  number  of  machine  dependent  routines. 
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3.1 .  MACHINE  DEPENDENT  CODE 


The  machine  dependent  interface  has  been  designed  such  that  approximately  40  routines  are 
needed  to  complete  the  connection  between  ASTROS  and  the  host  system.  The  development  of  the 
machine  dependent  interfaces  can  be  done  in  a  straightforward  manner  on  most  machines  with  more 
complexity  required  for  sophisticated  interfaces  or  for  alternative  host  architectures.  The  typical  AS¬ 
TROS  user  will  not  be  willing  to  perform  any  but  the  most  rudimentary  duplication  of  the  standard, 
supported  installation  dependent  interface,  although  anyone  familiar  with  the  host  computer  system 
could  accomphsh  the  task.  Installation  at  sites  using  machines  that  are  much  like  the  ones  already 
supported  is  fairly  simple,  although  even  the  installation  of  ASTROS  on  identical  host  machines  can 
require  some  modification  to  the  machine  dependent  code  since  some  parameters  and  code  are  site 
dependent  as  well  as  machine  dependent. 

The  machine  dependent  code  is  separated  into  two  libraries:  the  general  library,  denoted  by 
names  starting  with  xx,  and  the  database  machine  dependent  library,  denoted  by  names  starting  with 
DBMD.  The  general  library  consists  of  timing  routines,  bit  manipulation  routines,  some  character  string 
manipulation  routines,  a  random  number  generator  and  a  BLOCK  data  subroutine  containing  a  number 
of  machine  and  installation  dependent  parameters.  The  timing  routines  and  the  random  number  gener¬ 
ator  are  site  dependent  in  that  each  facility  typically  has  a  library  of  such  routines.  The  BLOCK  DATA 
contains  such  parameters  as  the  open  core  size,  the  definition  of  logical  units,  output  paging  parameters 
and  other  site  dependent  parameters.  The  remainder  of  the  routines  are  very  simple  and  typically  do  not 
vary  substantially  from  site  to  site,  although  they  are  different  between  machines.  In  some  cases,  the 
xx-routines  are  written  in  standard  FORTRAN  and  are  in  the  machine  dependent  library  only  because 
some  host  systems  provide  special  routines  to  perform  these  tasks. 

The  database  machine  dependent  library  (dbmd)  is  much  more  complex  than  the  general  machine 
dependent  library.  The  complication  arises  because  of  the  flexibility  of  the  machine  dependent  interface 
and  because  of  the  natmre  of  the  interface.  Unlike  the  XX  library,  the  DBMD  library  deals  with  file 
structures  and  I/O  to  the  host  system  and  with  memory  management.  These  issues  are  highly  machine 
dependent  and  are  further  complicated  because  the  translation  of  machine  independent  parameters  like 
file  names  to  the  actual  host  system  file  name  may  need  to  be  very  flexible  depending  on  the  nature  of 
the  local  host  system.  The  ASSIGN  DATABASE  entry  in  ASTROS  allows  the  user  to  enter  machine 
dependent  parameters  associated  with  the  data  base  file  attachment.  A  major  task  in  writing  the  DBMD 
library  is  the  definition  of  these  parameters  and  the  rules  for  their  use:  in  general  they  are  used  to  enable 
the  user  to  modify  the  default  file  attributes.  For  example,  block  sizes;  or  their  location  on  a  physical 
device,  such  as  disk  volume.  The  flexibihty  inherent  in  the  machine  dependent  interface  can  cause 
difiBculties  in  writing  the  DBMD  code,  however,  in  that  the  code  developer  may  find  it  hard  to  differentiate 
those  aspects  of  the  interface  that  are  free  to  be  redefined  from  those  that  are  required  by  ASTROS.  In 
the  authors’  experience,  however,  the  task  has  proven  to  be  tractable  for  all  host  systems  used  thus  far  by 
using  the  existing  routines  as  a  model.  The  reader  should  be  imder  no  illusion,  however,  that  the  task  of 
writing  the  DBMD  machine  dependent  library  is  simple. 

The  following  sections  document  the  XX  and  DBMD  machine  dependent  hbraries  in  a  machine 
independent  manner.  Each  routine  that  is  essential  to  the  ASTROS  interface,  its  calling  sequence  and  its 
design  requirements  is  listed.  It  is  very  important  to  appreciate  that  the  actual  machine  dependent 
interface  may  require  additional  routines  that  are  not  documented  in  these  sections.  The  only  routines 
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that  are  shown  here  are  those  that  are  referenced  by  the  machine  independent  portions  of  ASTROS.  By 
definition,  it  is  these  routines  that  constitute  the  machine  dependent  interface.  It  is  often  desirable  and 
sometimes  necessary  for  the  machine  dependent  code  to  call  other  machine  dependent  routines.  These 
internal  interfaces  are  not  documented  in  this  report  because  of  their  high  degree  of  dependence  on 
particular  host  machines  and/or  site  configurations.  It  is  completely  up  to  the  discretion  of  the  code 
developer  to  decide  whether  such  routines  are  desirable  and  what  tasks  they  should  perform.  In  fact, 
there  are  no  requirements  of  any  kind  for  the  machine  dependent  code  except  those  imposed  by  the 
definition  of  the  interface  (calling  sequence  and  design  assumptions).  It  is  that  very  flexibility  that  makes 
the  machine  dependent  code  generation  difficult. 

3.1 .1 .  General  Dependent  Code 

The  following  sections  document  each  of  the  general  machine  dependent  routines  contained  in  the 
XX  hbrary.  These  routines  tend  to  be  highly  site  dependent  as  well  as  machine  dependent,  but  are 
relatively  straightforward  to  develop.  Their  functions  are  simple  and  do  not  deal  with  the  major  machine 
dependencies  like  I/O  and  word  sizes. 
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Machine  Dependent  Utility  Module:  DOUBLE 
Entry  Point:  DOUBLE 


Purpose: 

Machine  dependent  logical  function  to  determine  the  machine  precision  as  one  of  single  or  double 
precision. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

DOXJBLE  (  ) 

Method: 

DOXJBLE  returns  a  .  true  .  if  the  machine  precision  is  double  or  a  .  false  .  if  it  is  single  ASTROS  then 
produces  all  matrix  entities  and  assumes  that  all  matrix  entities  are  of  the  machine  precision.  Mixing 
single  and  double  precision  matrices  is  not  supported  by  ASTROS  code.  DOUBLE  should  be  used  by  all 
apphcation  modules  that  use  matrix  entities. 

Design  Requirements: 

1.  All  matrix  operations  must  be  either  single  or  double,  not  mixed. 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module;  XXBCLR 
Entry  Point:  XXBCLR 


Purpose: 

Machine  dependent  integer  function  to  clear  a  bit  in  an  array. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

XXBCLR  {  ARRAY,  BIT  ) 

Method: 

The  bit  manipulation  routines  all  assume  that  the  bit  identifier  can  vary  from  1  to  any  positive  integer. 
A  consistent  set  of  assumptions  on  the  correspondence  of  bit  to  a  word/bit  combination  in  array  must 
be  made  for  aU  bit  routines. 

Design  Requirements: 

1.  For  machine  independent  use,  application  program  units  should  size  ARRAY  based  on  32  or  fewer 
bits  per  word. 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXBD 

Entry  Point:  XXBD 

Purpose: 

A  block  data  subroutine  to  initialize  machine  or  installation  dependent  parameters. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

None 

Method: 

The  XXBD  block  data  establishes  the  values  of  machine  dependent  constants.  These  parameters  include 

any  constant  that  may  be  needed  for  the  machine  dependent  library  as  well  as  the  following  installation 

or  machine  dependent  values  required  by  the  ASTROS  machine  independent  routines: 

(1)  The  size  of  the  open  core  common  block  /MEMORY/  in  single  precision  words. 

(2)  System  dependent  precision  terms  for  the  large  matrix  utilities  and  memory  management 

(3)  The  parameters  identifying  the  name  and  password  of  the  ASTROS  system  database.  These  must 
correspond  to  those  used  in  the  SYSGEN  program. 

(4)  The  number  of  bytes  and  bits  in  a  single  precision  word,  the  number  of  characters  that  will  be  stored 
in  a  hollerith  word  and  the  FORTRAN  format  statement  to  read  or  write  one  hollerith  word. 

(5)  The  set  of  "large"  and  "small"  numbers  for  the  machine,  including  a  large  real  number,  a  small  real 
number,  the  square  root  of  a  small  real  number  and  the  largest  integer  value  supported  by  the  host 
system. 

(6)  The  installation  dependent  number  of  lines  per  page  and  the  maximum  number  of  output  lines  that 
will  be  used  by  the  ASTROS  page  utility,  dtpage. 

(7)  The  ASTROS  and  SYSGEN  version  and  release  identifiers. 

(8)  The  installation  dependent  set  of  logical  unit  numbers  identifying  the  read/write/punch  units  and 
the  unit  to  be  used  for  the  include  files,  intermediate  storage  of  the  executive  timing  summary  and 
the  queued  storage  of  the  error  messages. 

(9)  System  dependent  null  values  for  relational  entity  attribute  types 
Design  Requirements: 

1.  The  logical  tinits  specified  in  the  XXBD  block  data  must  not  conflict  with  those  identified  in  the 
database  machine  dependent  block  data  DBBD  for  the  database  files. 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXBSET 
Entry  Point:  XXBSET 


Purpose: 

Machine  dependent  routine  to  set  a  bit  in  an  array. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XXBSET  (  ARRAY,  BIT  ) 

Method: 

The  bit  manipulation  routines  all  assiune  that  the  BIT  identifier  can  vary  from  1  to  any  positive  integer. 
A  consistent  set  of  assumptions  on  the  correspondence  of  BIT  to  a  word/bit  combination  in  ARRAY  must 
be  made  for  all  bit  routines. 

Design  Requirements: 

1.  For  machine  independent  use,  application  program  units  should  size  array  based  on  32  or  fewer 
bits  per  word. 

Error  Conditions: 


None 


Machine  Dependent  Utility  Module:  XXBTST 
Entry  Point:  XXBTST 


Purpose: 

Machine  dependent  logical  function  to  test  a  bit  in  an  array. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

XXBTST  (  ARBAY,  BIT  ) 

Method: 

The  bit  manipulation  routines  all  assume  that  the  bit  identifier  can  vary  from  1  to  any  positive  integer. 
A  consistent  set  of  assumptions  on  the  correspondence  of  BIT  to  a  word^it  combination  in  ARRAY  must 
be  made  for  all  bit  routines. 

Design  Requirements: 

1.  For  machine  independent  use,  application  program  luiits  should  size  array  based  on  32  or  fewer 
bits  per  word. 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXCLOK 


Entry  Point:  XXCLOK 


Machine  dependent  routine  to  return  the  time  of  day  as  a  character  string  and  as  a  number  of  seconds 
past  midnight. 

MAPOL  Calling  Sequence: 


Application  Calling  Sequence: 

CALL  XXCLOK  {  TIME,  ISEC  ) 

time  Character  string  containing  the  time  of  day  as  HHtMM:  SS  (Character,  Out¬ 

put) 

ISEC  Integer  number  of  seconds  since  midnight.  (Integer,  Output) 

Method: 


Design  Requirements: 


Error  Conditions: 
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Machine  Dependent  Utility  Module:  XXCPU 
Entry  Point:  XXCPU 


Purpose: 

Machine  dependent  routine  to  return  the  elapsed  CPU  time  in  seconds. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XXCPU  (  CPU  ) 

CPU  Number  of  seconds  of  CPU  time  used  since  the  job  started.  (Real,  Output) 

Method: 

On  the  first  call  to  XXCPU,  the  utility  must  initialize  the  system  CPU  timer  and  return  0.0  elapsed 
seconds.  On  subsequent  calls,  the  elapsed  CPU  time  in  seconds  is  returned. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXDATE 
Entry  Point:  XXDATE 


Purpose: 

Machine  dependent  routine  to  return  the  date  as  a  character  string  mm/dd/ YY. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XXDATE  {  TODAY  ) 

TODAY  Character  string  containing  the  date  as  MM/DD/YY.  (Character,  Output) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXFLSH 

Entry  Point:  XXFLSH 

Piirpose: 

Machine  dependent  routine  to  flush  any  data  in  the  buffer  for  a  given  logical  unit. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XXFLSH  (  LU  ) 

LU  The  logical  unit  number  of  the  file  whose  biiffer  is  to  be  flushed.  (Integer, 

Input) 

Method: 

The  XXFLSH  routine  wiU  typically  be  a  return.  On  machines  that  support  the  ability  to  finish  the  I/O 
buffer  for  a  file,  however,  the  XXFLSH  routine  should  call  that  routine  to  flush  the  buffer  to  the  file. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Error  Conditions: 
None 
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Machine  Dependent  Utility  Module:  XXITOS 

Entry  Point:  XXITOS 

Purpose: 

Machine  dependent  routine  to  return  the  character  representation  of  an  integer. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XXITOS  (  N,  V  ) 

N  Input  integer 

V  Output  character  string 

Method: 

This  routine  may  be  written  in  standard  FORTRAN  77  using  the  internal  file  feature  to  write  the  integer 
onto  the  character  string.  It  is  often  more  efficient  to  crack  the  integer  into  its  constituent  digits.  Some 
machines  have  local  utilities  that  may  be  used. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXLSFT 

Entry  Point:  XXLSFT 

Purpose: 

Machine  dependent  integer  function  to  shift  bits  to  the  left  in  an  integer  word. 

Function  Arguments: 

XXLSFT  (  INT,  MBIT  ) 

INT  Input  integer 

MBIT  Integer  number  of  bits  to  shift  left' 

Method: 

The  machine  independent  use  of  this  function  requires  that  NBIT  be  less  than  the  smallest  number  of 
bits  in  a  word  for  any  target  machine  (typically  32). 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXNOT 

Entry  Point:  XXNOT 

Purpose: 

Machine  dependent  integer  function  that  returns  the  complement  of  INT. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

XXNOT  {  INT  ) 

INT  Input  integer 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXOVFL 
Entry  Point:  XXOVFL 


Purpose: 

Machine  dependent  routine  to  test  for  floating  point  overflow  or  underflow  and  return  a  flag  denoting 
which  has  occurred. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XXOVFL  (  J  ) 

j  Integer  value  returned  based  on  the  over/underflow  condition: 

=  1  floating  point  overflow  exists 
=  2  no  error  condition 
=  3  floating  point  underflow  exists 

Method: 

In  the  case  of  this  special  routine,  if  the  host  system  does  not  have  an  XXOVFL  type  of  routine,  it  is 
necessary  to  return  a  J=2  value  for  all  calls  to  XXOVFL.  In  this  case,  the  host  system  will  be  relied  upon 
to  indicate  the  occmnence  of  a  floating  point  error. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXRAND 

Entry  Point:  XXRAND 

Purpose: 

Machine  dependent  function  that  rettims  a  random  single  precision  number  between  0.0  and  1.0. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

XXKAND  (  ) 

Method: 

Returns  uniformly  distributed  random  numbers. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXRSFT 
Entry  Point:  XXRSFT 


Purpose: 

Machine  dependent  integer  function  to  shift  bits  to  the  right  in  an  integer  word. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

XXRSFT  (  INT,  MBIT  ) 

INT  Input  integer 

mbit  Integer  number  of  bits  to  shift  right 

Method: 

The  machine  independent  use  of  this  function  requires  that  MBIT  be  less  than  the  smallest  number  of 
bits  in  a  word  for  any  target  machine  (t)q)ically  32). 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXRTOS 

Entry  Point:  XXRTOS 

Purpose: 

Machine  dependent  routine  to  return  the  character  representation  of  a  real  number. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XXRTOS  {  REL,  STR  ) 

REL  Input  real  number 

STR  Output  character  string 

Method: 

This  routine  may  be  written  in  standard  FORTRAN  77  using  the  internal  file  feature  to  write  the  real 
onto  the  character  string.  It  is  often  more  efficient  to  crack  the  real  into  its  constituent  digits.  Some 
machines  have  local  utilities  that  may  be  used. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  XXULNS 

Entry  Point:  XXULNS 

Purpose: 

Machine  dependent  routine  to  retiun  the  used  length  of  a  character  string. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XXULNS  {  STR,  ULEN  ) 

STR  Character  string  (Character,  Input) 

ULEN  The  position  of  the  last  nonblank  character  (the  first  character  in  the 

string  is  character  1).  (Integer,  Output) 

Method: 

The  XXULNS  routine  may  be  written  in  standard  FORTRAN  77  using  the  LEN  function  to  return  the 
total  length  and  then  looking  backwards  for  the  first  nonblank  character.  Certain  hosts  may  benefit 
from  a  machine  dependent  approach  when  byte  operations  are  expensive. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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3.1 .2.  Database  Dependent  Code 


The  following  sections  document  each  of  the  database  machine  dependent  routines  contained  in 
the  DBMD  library.  These  routines  tend  to  be  site  independent,  but  are  highly  machine  dependent.  Their 
development  on  a  new  host  system  can  become  quite  complex  depending  on  the  desired  sophistication  of 
the  interface.  These  routines  deal  with  file  structures  I/O  and  memory  management  as  well  as  certain 
CPU  critical  string  manipulation  functions. 
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Machine  Dependent  Utility  Module:  dbmdab 
Entry  Point:  DBMDAB 


Purpose: 

Tb  abort  the  execution  of  ASTROS  due  to  a  database  or  memory  management  fatal  error. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDAB  (  FIiAG  ) 

plaq  An  integer  input  denoting  whether  the  executive  termination  utility 

XQENDS  is  to  be  called  or  not. 

=  0,  call  XQENDS,  otherwise  stop 


Method: 

The  DBMDAB  routine  is  set  up  to  avoid  the  recursion  that  can  occur  due  to  the  termination  actions  taken 
by  the  xqends  termination  utility.  Since  the  database  and  memory  manager  are  calling  for  the  abort, 
the  XQENDS  routine’s  attempts  to  close  the  database  files  often  cause  the  DBMDAB  routine  to  be  called 
again.  Hence,  the  flag  argument  is  input  to  denote  that  the  abort  condition  is  such  that  any  attempts 
to  close  the  database  will  cause  recursion. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module;  DBMDAN 

Entry  Point:  DBMDAN 

Ptirpose: 

Machine  dependent  integer  function  that  returns  the  logical  and  of  INTI  and  INT2. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

DBMDAN  (  INTI,  INT2  ) 

INTI  Input  integer 

INT2  Input  integer 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  DBMDCH 
Entry  Point:  DBMDCH 


Purpose: 

lb  convert  a  character  variable  of  arbitrary  length  into  an  integer  array  with  four  hollerith  characters 
per  word. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDCH  (  CVAR,  IVAR,  LEN  ) 

CVAR  An  input  character  variable  of  arbitrary  length 

IVAR  The  output  integer  array  containing  the  hollerith  equivalent  of  cvar 

T.'gw  An  input  integer  denoting  the  number  of  characters  to  be  placed  in  IVAR. 

T.Tgw  should  always  be  a  multiple  of  four,  this  routine  pads  with  blanks  as 
needed. 


Method: 

The  DBMDCH  routine  is  used  extensively  by  the  database  routines  to  convert  user  supplied  character 
variables  into  hollerith  integers  for  subsequent  processing.  It  is  critical  for  performance  that  tMs  routine 
be  efficient.  For  implementation  purposes,  it  must  be  assumed  that  the  input  character  string  can  be 
of  any  length,  but  the  output  hollerith  variable  must  always  have  four  characters  per  word.  Any  extra 
bytes  left  unused  are  filled  with  blanks. 

The  only  way  standard  FORTRAN  provides  to  convert  character  data  to  hollerith  data  is  with  an  incore 
file  operation  using  the  FORTRAN  read.  While  this  method  works  on  all  machines,  it  is  typically  very 
slow  and  causes  severe  performance  penalties.  This  method  can  be  avoided  in  most  cases  since  compilers 
typically  pass  two  arguments  for  every  character  variable  with  the  virtual  argument  containing  the 
character  length.  The  virtual  argument  either  follows  the  character  argument  directly  or  is  passed  at 
the  end  of  the  list  of  actual  arguments .  blowing  this,  this  routine  can  usually  be  written  using  all  integer 
data  thereby  producing  much  faster  code. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  DBMDCX 

Entry  Point:  DBMDCl 

Purpose: 

To  perform  phase  1  of  database  configuration  initialization. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDCl  {  NWORD  ) 

NWORD  Number  of  words  required  in  dbnt  (Integer,  Output) 

Method: 

Phase  1  of  the  database  configuration  normally  involves  the  determination  of  default  values  for  the 
database.  The  values  that  can  be  changed  are  defined  in  the  /dbcons/  common  block.  These  values 
can  be  hard  coded  in  this  routine,  hard  coded  in  the  DBBD  block  data  routine  or  read  from  a  configuration 
file. 

The  only  required  function  of  the  routine  is  to  return  the  nxunber  of  words  in  the  system  dependent 
portion  of  the  DBNT. 

Design  Requirements: 

None 

Error  Conditions: 

None 

Entry  Point:  DBMDC2 
Purpose: 

To  perform  phase  2  of  database  configuration  initialization. 

MAPOL  Calling  Sequence: 

None 

Apphcation  Calling  Sequence: 

CALL  DBMDC2  {  DBNT  ) 

DBNT  Database  name  table  (Integer,  Input) 
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Method: 


When  phase  2  of  the  database  configuration  is  performed,  the  DENT  table  has  been  allocated  and  partially 
initialized.  This  routine  must  initialize  the  system  dependent  portion  of  the  table.  The  location  of  this 
data  can  be  found  as  follows. 

DBENTSD  =  Z  (DBNT  +  DBNSD) 

Z(DBENTSD  +  xx)  =  machine  dependent  data  _ 


It  is  also  the  responsibility  of  this  routine  to  make  sure  that  all  of  the  following  variables  in  /dbcons/ 
have  legal  values. 

default  number  of  data  files 


DBDFIL 

DBMFIIi 

DBDEFD 

DBDEFI 

DBMAXE 

DBMAXD 

DBMAXN 

DBALGN 


maximum  number  of  data  files 
default  data  file  block  size 
default  index  file  block  size 
maximum  number  of  ENT  entries 
maximum  number  of  dbnt  entries 
maximum  number  of  NST  entries 
required  buffer  alignment 


Design  Requirements: 
None 

Error  Conditions: 
None 
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Machine  Dependent  Utility  Module:  DBMDDT 

Entry  Point:  DBMDDT 

Purpose: 

To  return  the  time  and  date  in  hollerith  formats. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDDT  (  DATE,  TIME  ) 

DATE  Date  in  form  MM/DD/YY  (2  integer  words,  output) 

TIME  Time  in  form  HH :  MM :  SS  (2  integer  words,  output) 

Method: 

This  subroutine  should  return  the  current  date  and  time  in  the  appropriate  locations.  Each  value 
retTimed  should  be  stored  in  two  integer  words  with  four  hollerith  characters  per  word. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  DBMDER 

Entry  Point:  DBMDER 

Purpose: 

Tb  handle  machine  and  installation  dependent  error  conditions  for  the  database  and  memoiy  manager. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDER  (  ERROR  ) 

ERROR  A  character  argument  containing  an  error  message  identifier. 

Method: 

The  DBMDER  routine  is  intended  to  be  used  in  two  ways.  The  first,  denoted  by  a  blank  character  string 
on  input,  is  to  activate  any  machine  dependent  error  handling.  This  is  the  interface  to  the  dbmder 
routine  fi-om  the  machine  independent  library.  For  example,  the  DBMDER  routine  typically  invokes  the 
host  dependent  mechanism  to  obtain  a  traceback  to  assist  in  locating  the  source  of  an  error.  The  second 
interface,  using  nonblank  character  strings  on  input,  is  intended  for  use  by  the  machine  dependent 
(DBMD)  hbrary.  In  this  function,  the  DBMDER  routine  typically  writes  out  error  messages  identiftdng  the 
nature  of  the  (machine  dependent)  error  condition.  This  is  useful  for  error  checking  the  file  naming 
conventions,  host  I/O  limitations,  and  other  host  dependent  user  interfaces  to  the  ASTROS  system. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  dbmdfp 

Entry  Point:  DBMDFP 

Purpose: 

An  integer  function  to  reorder  the  bytes  in  an  integer  word. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

DBMDFP  (  INUM  ) 

INUM  An  integer  word  whose  b3rtes  are  to  be  reordered 

Method: 

On  certain  machines  (notably  VAX),  the  bytes  in  an  integer  word  are  stored  in  an  order  right  to  left. 
When  hollerith  data  are  used,  this  feature  complicates  the  comparison  of  two  hollerith  words.  This 
routine  is  called  to  reorder  the  b5d:es  in  an  integer  word  to  be  left  to  right,  independent  of  the  storage 
format  on  the  machine.  On  machines  that  do  not  swap  bytes,  the  dbmdfp  function  value  should  be  set 
equal  to  the  INUM  value. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  dbmdhc 

Entry  Point:  DBMDHC 

Purpose: 

To  convert  an  integer  array  with  four  hoUerith  characters  per  word  into  a  character  variable  of  arbitrary 

length. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDHC  (  IVAR,  CVAR,  LEN  ) 

I  VAR  The  input  integer  array  containing  the  hollerith  characters. 

CVAR  An  output  character  variable  containing  the  character  representation  of 

the  hollerith  IVAR. 

T.wM  An  input  integer  denoting  the  number  of  characters  in  IVAR  to  convert 

and  place  in  CVAR.  LEN  should  always  be  a  multiple  of  four,  the  routine 
truncates  or  pads  with  blanks  as  needed. 


Method: 

The  DBMDHC  routine  is  used  extensively  by  the  database  routines  to  convert  hollerith  integer  into 
character  variables  for  subsequent  processing.  It  is  critical  for  performance  that  this  routine  be  efficient. 
For  implementation  purposes  it  must  be  assumed  that  the  output  character  string  can  be  of  any  length 
and  the  input  hollerith  variable  must  have  four  characters  per  word  as  generated  by  dbmdhc. 

The  only  way  standard  FORTRAN  provides  to  convert  hollerith  data  to  character  data  is  with  an  incore 
file  operation  using  the  FORTRAN  write.  While  this  method  works  on  all  machines,  it  is  typically  very 
slow  and  causes  severe  performance  penalties.  This  method  can  be  avoided  in  most  cases  since  compilers 
typically  pass  two  arguments  for  every  character  length.  The  virtual  argument  either  follows  the 
character  argument  directly  or  is  passed  at  the  end  of  the  list  of  actual  arguments.  Knowing  this,  this 
routine  can  usually  be  written  using  all  integer  data  which  produces  much  faster  code. 

Design  Requirements: 

None 

Error  Conditions: 


None 


Machine  Dependent  Utility  Module:  DBMDHX 

Entry  Point:  DBMDHX 

Purpose: 

To  dump  a  portion  of  memory  in  a  hexadecimal  or  octal  format. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBHDHX  (  ARRAY,  LEN  ) 

ARRAY  Input  array  containing  data  to  be  dumped 

LEN  Number  of  single  precision  words  to  dump 

Method: 

If  a  database  error  occurs,  portions  of  the  in  core  control  tables  are  dumped  to  help  diagnose  the  problem. 
It  is  most  often  desirable  to  see  this  data  in  a  combined  hex/octal  and  character  format.  This  routine 
usually  dumps  the  desired  data  in  the  following  form: 

OFFH  OFFD  . hex/octal  data . character  data 

OFFH  -  hex/octal  offset  of  the  data  from  /memory/ 

OFFD  -  decimal  offset  of  the  data  from  /memory/ 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  DBMDIX 

Entry  Point:  DBMDI 1 

Purpose: 

Phase  1  of  database  I/O  initialization. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDIl  (  NAME,  STAT,  RW,  USRPRM,  NFILE,  NWORD  ) 

NAME  Database  name  (Character,  Input) 

STAT  Database  status  (OLD,  NEW,  TEMP,  SAVE,  or  PERM)  (Input) 

RW  Read/write  flag  (RO,  WO,  R/W,  Input) 

USRPRM  User  parameters  (Character,  Input) 

NFILE  Number  of  data  files  in  database  (Integer,  Output) 

NWORD  Number  of  words  required  for  each  file  in  DBDB  (Integer,  Output) 

Method: 

Phase  1  of  the  I/O  initiahzation  is  responsible  for  determining  two  values:  the  number  of  data  files  in 
the  database  and  the  number  of  system  dependent  words  required  for  each  file  in  the  DBDB.  The  DBINIT 
call  is  provided  with  an  argument  called  USRPRM.  The  contents  of  this  character  string  are  completely 
machine  dependent  and  can  be  used  to  specify  any  special  processing.  Examples  of  these  fields  are 
provided  in  Section  1  of  the  User’s  Manual. 

The  most  difficult  function  of  this  routine  is  to  determine  the  number  of  data  files  for  a  database.  The 
following  ways  could  be  used. 

1.  If  the  database  has  a  status  of  new  or  temp,  the  number  of  data  files  is  either  the  default  or  entered 
using  the  USRPRM. 

2.  If  the  database  has  a  status  of  OLD,  the  number  of  data  files  can  either  be  a  hard  coded  value  (usually 
1)  or  can  be  determined  by  opening  files  with  the  appropriate  names  ruitil  an  open  fails. 

For  OLD  databases  this  routine  should  also  determine  the  index  and  data  file  block  sizes.  This  can 
usually  be  done  by  one  of  the  following  two  methods. 

1.  Inquire  as  to  the  physical  attributes  of  the  file  to  determine  the  block  sizes. 

2.  Do  a  sequential  read  of  the  first  block  of  the  index  file  and  extract  the  index  and  data  file  block  sizes 
that  are  stored  there. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Entry  Point:  DBMDI2 
Purpose: 

Phase  2  of  database  I/O  initialization. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDX2  (  DBDB  ) 

DBDB  Database  Descriptor  Block  (Integer,  Input) 

Method: 

When  phase  2  of  the  database  I/O  initialization  is  performed,  the  DBDB  table  has  been  allocated  and 
partially  initialized.  This  routine  must  initialize  the  system  dependent  portion  of  the  table.  There  are 
also  several  words  in  the  machine  independent  portion  of  the  DBDB  that  must  be  initialized  for  each 
index  and  data  file.  The  following  code  shows  how  these  words  are  located. 

For  the  Index  file: 

r  DBDDBO  =  DBDB  +  DBDIFB  ~~  | 

For  the  Data  files: 

r  DBDBQ  =  DBDB  +  DBDDTA  4-  (  IFILE-1)  *LENDDE  | 


For  all  fQes: 


DBDBSD  =  Z{DBDBO+DBDOSD) 


Z{DBDB+DBDIBS) 
Z(DBDB+DBDDBS) 
Z (DBDB+DBDMDF) 
Z (DBDB+DBDONB) 
Z (DBDB+DBDOMB) 


Index  file  block  size  in  words 
Data  file  block  size  in  words 
Maximum  number  of  data  files 
Current  number  of  blocks  in  the  file 
Maximum  number  of  blocks  allowed  in  the  file 


Z(DBDBSD+XX)  =  Machine  dependent  data 


This  routine  will  typically  do  any  physical  open  or  assign  calls  that  are  required  to  make  all  the  index 
and  data  files  for  this  database  available  for  processing. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  dbmdlc 
Entry  Point:  DBMDLC 


Purpose: 

An  integer  function  to  provide  the  memory  manager  with  an  address  of  a  character  memory  location  in 
particular  precisions. 

MAPOL  Calling  Sequence: 


None 

Application  Calling  Sequence: 

DBMDLC  (  BASE,  PREC,  STAT  ) 
BASE 
PREC 


STAT 


An  input  character  array  whose  absolute  address  is  desired. 

An  input  integer  denoting  the  desired  precision  of  the  address 
=  0  b3d;e  address 
=  1  word  address 
=  2  double  precision  word  address 

An  output  integer  value  that  is  nonzero  if  any  error  conditions  occurred. 


Method: 

The  routine  determines  the  absolute  address  of  base  and  modifies  the  offset  value  to  accoTont  for  the 
precision  of  the  desired  address.  For  example,  the  VAXmachine  returns  the  byte  address  from  the  system 
utility  %LOCF.  To  obtain  the  word  address  for  the  VAX,  the  byte  address  is  divided  by  the  number  of 
bytes  per  word  (four).  A  check  is  made  to  determine  if  the  byte  address  is  an  even  multiple  of  four  and/or 
eight  to  check  the  single  and  double  word  alignment. 

Design  Requirements: 

1.  This  routine  is  identical  to  dbmdlp  except  that  the  base  array  in  this  routine  is  character  rather 
than  integer. 

Error  Conditions: 

1.  On  certain  machines,  there  is  a  requirement  that  the  memory  addresses  be  aligned  on  single  and/or 
double  word  boundaries.  This  routine  should  perform  these  checks  and  return  the  proper  STAT  value 
if  the  required  alignments  are  not  met. 
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Machine  Dependent  Utility  Module: 


DBMDLF 


Entry  Point:  DBMDLF 
Purpose: 

An  integer  function  to  provide  the  memory  manager  with  an  address  of  an  memory  location  in  particular 
precisions. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

DBMDLF  {  BASE,  PREC,  STAT  ) 


BASE  An  input  integer  array  whose  absolute  address  is  desired. 

PREC  An  input  integer  denoting  the  desired  precision  of  the  address 

=  0  hyte  address 
=  1  word  address 
=  2  double  precision  word  address 

STAT  An  output  integer  value  that  is  nonzero  if  any  error  conditions  occurred. 


Method: 


The  routine  determines  the  absolute  address  of  BASE  and  modifies  the  offset  value  to  account  for  the 
precision  of  the  desired  address.  For  example,  the  VAX  machine  returns  the  byte  address  from  the  system 
utility  5SLOCF.  Ib  obtain  the  word  address  for  the  VAX,  the  byte  address  is  divided  by  the  number  of 
bytes  per  word  (four).  A  check  is  made  to  determine  if  the  byte  address  is  an  even  multiple  of  four  and/or 
eight  to  check  the  single  and  double  word  ahgnment. 


Design  Requirements: 

1.  This  routine  is  identical  to  DBMDLC  except  that  the  BASE  array  in  this  routine  is  integer  rather  than 
character. 


Error  Conditions: 

1.  On  certain  machines,  there  is  a  requirement  that  the  memory  addresses  be  ahgned  on  single  and/or 
double  word  boundaries.  This  routine  should  perform  these  checks  and  return  the  proper  STAT  value 
if  the  required  alignments  are  not  met. 
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Machine  Dependent  Utility  Module:  DBMDMM 
Entry  Point:  DBMDMM 


Purpose: 

Initializes  machine  dependent  parameters  for  the  memory  manager. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDMM  (  ICAWA,  IWLIC  ) 

ICAWA  An  output  integer  indicating  if  characters  are  word  aligned  on  the  host 

machine: 

=  0  if  character  variables  are  word  aligned 
=  1  if  character  variables  are  not  word  aligned 


IWLIC 

Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 


An  output  integer  containing  the  number  of  characters  stored  in  a  single 
precision  word  on  the  host  system. 
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Machine  Dependent  Utility  Module:  dbmdof 

Entry  Point:  DBMDOF 

Purpose: 

An  integer  function  to  return  a  FORTRAN  index  such  that  the  location  of  one  array  can  be  accessed  via 
another  array 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

DBMDOF  (  AREAYl,  ARHAY2  ) 

ARRAYl  One  FORTRAN  array  (Input) 

ARBAY2  Second  FORTRAN  array  (Input) 

Method: 

The  result,  dbmdof,  is  a  FORTRAN  index  such  that  the  same  memory  location  is  referenced  by  ARRAYl 
(dbmdof)  and  ARRAY2  (l) .  In  the  DBOFEN  call,  the  user  provides  a  20-word  INFO  array.  The  last  10 
words  of  this  block  are  available  for  any  required  user  data.  These  10  words  can  be  modified  anytime 
up  to  the  DBCDOS  call  for  the  entity.  Since  the  INFO  array  is  not  passed  on  the  dbclos  call,  the  dbopen 
call  must  remember  where  it  is  for  later  access  by  the  dbclos  call.  The  dbmdof  function  allows  the 
database  to  remember  where  the  INFO  block  is  by  saving  its  location  relative  to  the  /MEMORY/  common 
block  at  open  time. 

The  actual  implementation  of  the  call  usually  requires  some  method  for  obtaining  the  actual  address 
for  a  subroutine  argument. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module:  dbmdor 
Entry  Point:  DBMDOR 


Purpose: 

Machine  dependent  integer  function  that  returns  the  logical  OR  of  INTI  and  INT2 . 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

DBMDOR  (  INTI,  INT2  ) 

INTI  Integer  (Input) 

INT2  Integer  (Input) 


Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 
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Machine  Dependent  Utility  Module:  DBMDRD 
Entry  Point:  DBMDRD 


Purpose: 

To  read  a  block  from  the  database. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDRD  (  DBDB,  FILE,  BLK,  BtTFHD  ) 

DBDB  Database  Descriptor  Block  (Integer,  input) 

FILE  File  Number  (for  index  files,  FILE  =  0)  (Integer,  input) 

BLK  Block  Number;  if  file  <  0  then  BLK  is  IBLK*dbmfil  +  FILE 

(Integer,  input) 

BUFHD  The  I/O  header  location  (Intger,  input) 

Method: 

The  function  of  this  routine  is  to  read  a  block  from  the  database.  The  first  step  is  to  determine  the 
database  file  and  block  number  to  be  read,  the  following  code  will  perform  this. 

IF  {FILE  .LT.  0)  THEN 

IBLK  =  BLK/DBMFIL 
IFILE  =  BLK  -  IBLK*DBMFIL 

ELSE 

IBLK  =  BLK 
IFILE  =  FILE 

ENDIF 


The  block  should  then  be  read  into  the  I/O  buffer  using  the  appropriate  calls  for  the  target  system.  The 
machine  independent  DBDB  data,  referenced  from  DBDBO,  and  machine  dependent  DBDB  data,  referenced 
from  DBDBSD  can  be  obtained  from  the  buffer  header.  The  number  of  words  to  transfer,  BLKSIZ,  is 
obtained  from  the  DBDB. 


IF (IFILE  .EQ.  0)  THEN 

DBDBO  =  DBDB  +  DBDIFB 
BLKSIZ  =  Z (DBDB+DBDIBS) 

ELSE 

DBDBO  =  DBDB  +  DBDDTA  +  (IFILE- 1 ) *LENDDE 
BLKSIZ  =  Z(DBDB+DBDDBS) 

ENDIF 

BUFIO  =  Z{BUFHD+BFIOBF) 

DBDBSD  =  Z(  DBDBO -t-DBDOSD) _ 
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After  the  I/O  operation,  the  following  two  words  of  the  buffer  header  shotdd  be  updated: 


Z  (BUFHD+BFPBLK)  =  IBIjK*DBMFIL  +  IFILE 
Z (BUFHD+BFDBDB)  =  DBDB _ 


Design  Requirements: 
None 

Error  Conditions: 
None 


53 


Machine  Dependent  Utility  Module:  DBMDSI 
Entry  Point:  DBMDSI 


Purpose: 

Tb  return  the  integer  represented  by  a  character  string. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDSI  (  STR,  IVALTJE  ) 

STR  An  input  character  string  containing  digits  and  signs  representing  an  in¬ 

teger  value. 

IVALUE  An  output  integer  variable  containing  the  integer  value  represented  by 

the  input  character  string 

Method: 

This  routine  is  typically  written  in  standard  FORTRAN,  but  may  be  available  as  a  host  system  utility. 
Design  Requirements: 

1.  A  leading  +  or  -  sign  is  permitted  as  are  all  the  decimal  digits.  Any  other  characters  are  illegal. 
Error  Conditions: 

1.  If  the  character  string  does  not  represent  an  integer,  no  warnings  are  given  and  xvalue  is  set  to 
zero. 
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Machine  Dependent  Utility  Module:  DBMDTR 
Entry  Point:  DBMDTR 


Purpose: 

To  terminate  processing  of  a  database. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDTR  {  DBDB  ) 

dbdb  Database  Descriptor  Block  (Integer,  Input) 

Method: 

This  routine  is  called  at  program  termination  to  do  any  system  dependent  termination  processing  for 
each  database.  It  is  not  required  to  do  an5d:hing.  TVpic^ly  it  will  close  all  database  files. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module: 

Entry  Point:  DBMDWR 


DBMDWR 


Purpose: 

To  write  a  block  to  the  database. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDWR  {  BUFHD  ) 

BUFHD  I/O  buffer  header  location  (Integer,  Input) 

Method: 

The  function  of  this  routine  is  to  write  a  block  to  the  database.  The  processing  is  similar  to  dbmdrd  and 
the  same  information  is  available  to  the  routine. 

When  writing  this  routine  one  special  case  must  be  considered.  Because  of  the  d3mamic  way  in  which 
database  blocks  are  allocated  and  used,  it  can  never  be  assumed  that  the  database  blocks  are  appended 
in  sequential  order.  For  example  block  10  may  be  written  before  block  9.  If  this  situation  is  not  ^owed 
on  the  target  system  then  this  routine  should  write  dummy  blocks  to  fill  any  gap  before  writing  the 
target  block.  The  contents  of  these  dummy  blocks  is  unimportant. 

After  the  I/O  operation,  the  "buffer  modified"  flag  in  the  buffer  header  should  be  set  to  zero. 
r  Z(BUFHD4-BFM0D)  =  0 

Also,  this  routine  should  maintain  the  word  in  the  machine  independent  portion  of  the  dbdb  which 
indicates  the  number  of  blocks  on  the  physical  file. 

r  Z (DBDBO+DBDONB)  =  MAX ( IBLK, Z (DBDBQ+DBDQNB) )  | 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Machine  Dependent  Utility  Module: 

Entry  Point:  DBMDZB 


DBMDZB 


Purpose: 

To  find  the  first  zero  bit  in  a  word 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBMDZB  {  WORD,  BITNO  ) 

Word  to  be  searched  for  a  zero  bit  (Integer,  Input) 

Bit  number  found.  It  will  be  a  number  ranging  from  1  to  31  if  a  zero  bit 
was  found.  It  will  be  —1  if  all  31  bits  are  on.  (Integer,  Output) 


WORD 

BITNO 


Method: 

The  free  Block  Bit  Map  (fbbm)  uses  a  bit  to  represent  each  block  on  the  particular  database  file.  If  the 
bit  is  on,  the  block  is  allocated  and  if  the  bit  is  off,  the  block  is  rmallocated.  Each  word  in  the  FBBM  is 
used  to  represent  31  blocks.  The  bits  are  nximbered  as  follows: 


unused 


01 


02 


03 


31 


This  bit  numbering  scheme  must  be  maintained  regardless  of  the  bit  numbering  scheme  of  the  target 
system. 

The  DBMDZB  routine  should  return  the  first  zero  bit,  starting  firom  left  to  right.  If  all  bits  are  one,  then 
a  -1  is  returned.  This  function  typically  uses  the  FORTRAN  BTEST  function  (if  one  is  provided)  with 
appropriate  calculations  to  use  the  proper  bit  numbering  scheme. 


Design  Requirements: 
None 


Error  Conditions: 
None 
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3.2.  THE  SYSTEM  GENERATION  PROGRAM 


After  development  of  the  machine  dependent  source  code  for  the  target  host  machine,  the  next 
step  in  the  ASTROS  system  installation  is  the  assembly  of  the  executable  image  of  the  ASTROS  system 
generation  prograim,  SYSGEN.  The  libraries  that  must  be  linked  to  generate  this  program  have  been 
outlined  in  Section  2  of  this  manual  while  this  section  discusses  the  function  of  the  SYSGEN  program 
and  details  the  structure  of  its  inputs.  These  inputs  not  only  define  the  standard  ASTROS  system  but  are 
also  a  powerful  tool  for  an  advanced  user  to  expand  the  capabilities  of  the  system.  SYSGEN  represents 
one  of  the  most  useful  features  of  the  ASTROS  system  architecture  in  that  it  provides  for  automated 
modification  of  many  of  the  procedure’s  capabilities  without  requiring  modification  of  any  existing  source 
code. 

The  purpose  of  SYSGEN  is  to  create  a  system  database  (SYSDB)  defining  system  parameters 
through  the  interpretation  of  several  input  files.  Also,  a  FORTRAN  routine  is  written  by  SYSGEN  that 
provides  the  link  between  the  ASTROS  executive  system  and  the  apphcation  modules  that  comprise  the 
run-time  hbraiy  of  the  procedure.  This  program  imit  is  then  linked  with  the  system  during  the  assembly 
of  the  ASTROS  executable  image.  The  resultant  procedure  makes  use  of  the  system  database  as  a  pool  of 
data  that  defines  the  system  at  run  time.  These  data  are 

1.  the  contents  of  the  ASTROS  run-time  library  of  MAPOL  addressable  modules  including  both 
utility  and  application  modules,  usually  delivered  as  MODDEF.DAT  or  MODDEF.DATA; 

2.  the  ASTROS  standard  executive  sequence  composed  of  MAPOL  soxuce  code  statements,  usually 
delivered  as  MAPOLSEQ . DAT  or  MAPOLSEQ .DATA; 

3.  the  set  of  bulk  data  entries  mterpretable  by  the  system  and  defined  through  the  specification 
of  bulk  data  templates  to  be  interpreted  by  the  ASTROS  Input  File  Processor  (IFP),  usually 
delivered  as  template. DAT  or  template. DATA; 

4.  the  set  of  relational  schemata  used  by  the  executive  system  to  satisfy  the  declaration  of  relational 
variables  in  the  MAPOL  sequence  without  forcing  the  user  to  expHcitly  define  each  schema  at 
run  time,  usually  delivered  as  KELATIOM  .  DAT  or  belatxon  .  DATA;  and 

5.  the  set  of  error  message  texts  from  which  the  dtmwrt  system  message  writer  utility  builds  error 
messages  at  run  time,  usually  dehvered  as  SEKRMSG.dat  or  serrmsg.data. 

There  is  an  input  file  for  each  of  these  data  which  is  interpreted  by  SYSGEN  and  used  to  write 
data  to  SYSDB  in  particular  formats.  These  database  entities  are  then  used  by  the  ASTROS  executive 
system,  application  modules  and  utilities  to  perform  certain  functions.  Since  these  program  rmits  are 
designed  to  interpret  the  set  of  data  that  are  present  in  the  SYSDB  entities,  they  are  flexible  in  that 
virtually  any  changes  to  the  set  of  data  can  be  accommodated  without  modification  of  the  software  that 
uses  the  data. 

The  following  sections  each  contain  a  description  of  a  SYSGEN  input  file  and  of  the  SYSDB 
database  entities  that  are  filled  with  the  corresponding  data.  These  input  files  contain  the  definition  of 
the  system  as  developed  for  the  ASTROS  procedure.  The  advanced  user  may,  through  the  appropriate 
changes  to  these  inputs,  add  new  modules,  add  new  error  messages  that  may  be  useful  as  part  of  the 
additional  modrde(s),  add  new  bulk  data  iuputs,  add  new  relational  schemata  to  those  that  exist  or  add 
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new  attributes  to  an  existing  schema.  Finally,  the  standard  solution  algorithm  itself  can  be  modified, 
either  to  include  (as  a  permanent  modification)  a  new  feature  or  to  modify  an  existing  capability.  The 
advanced  user  is  cautioned,  however,  that  the  standard  sequence  represents  a  very  tightly  interwoven  set 
of  functions  and  any  changes  should  be  carefully  considered  for  their  ramifications  on  the  m\iltidiscipli- 
nary  features  of  the  system  as  it  is  currently  defined. 

3.2.1.  Functional  Module  Definition 

The  functional  modules  form  the  computational  heart  of  the  ASTROS  system.  A  sequential  file 
contains  character  data  records  that  define  the  following  information  for  each  module. 

1.  The  name  of  the  module 

2.  The  number  of  formal  parameters 

3.  If  the  module  is  a  function  or  a  procedure 

4.  The  type  of  each  formal  parameter 

5.  FORTRAN  code  lines  defining  the  module  call 
The  purpose  of  these  data  is  three-fold: 

1.  To  provide  the  names  of  modules  that  are  a  part  of  ASTROS 

2.  To  allow  the  vahdation  of  module  calls  including  type  checking  of  the  input  parameters 

3.  To  define  the  way  in  which  the  results  of  a  module  are  used  and  to  provide  the  actual  FORTRAN 
link  to  activate  a  module 

The  format  used  to  provide  these  data  is  described  in  the  following  section 


3.2.1 .1  The  File  Format 


The  module  definition  file  is  organized  as  a  sequence  of  module  entries. 


MODULE (1)  ENTRY 
MODULE (2)  ENTRY 


Each  module  entry  has  the  following  form: 


MODNAME,  NPARM 

{A8,I4) 

MODTYPE ,  PARMTYPE ( I ) 

(2014) 

FORTRAN  LINES 

(A80) 

END 

(A8) 
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where  the  first  line  consists  of  modname  and  NPAEM  and  the  second  line  consists  of  modtype  and  the  first 
19  PAKMTYPEs.  The  PARMTYPEs  continue,  20  per  line,  on  subsequent  lines,  as  required  to  supply  NPABM 
PABUTYPEs. 

The  lines  following  the  parmtypes  consist  of  FORTRAN  code  (including,  but  not  requiring, 
comments  or  blank  lines)  which  implements  the  module  interface  to  MAPOL. 


The  last  line  of  a  module  entry  is  the  word  END  starting  in  column  1. 

modname  is  the  module  name  as  it  appears  in  MAPOL;  1  to  8  characters  beginning 
with  a  letter.  The  name  is  left-justified  in  an  8-character  field. 

NPARM  is  the  number  of  formal  parameters  in  the  calling  list  of  the  module.  This  is 

a  right-justified  integer  in  a  4-digit  field.  There  is  a  limit  of  50  parameters. 
modtype  is  a  four-digit  code  for  the  module  t3rpe: 

100  means  the  module  is  a  function  with  a  fixed  number  of  parameters 

101  means  the  module  is  a  function  with  a  variable  number  of  parameters 

102  means  the  module  is  a  procedure 

PARMTYPE  The  declared  type  of  each  parameter  in  the  calling  list  selected  fi*om  the 
following  codes,  each  a  four-digit  integer: 

1  Integer 

2  Real 

3  Complex 

4  Logical 

5  Not  Used 

6  Not  Used 

7  Relational  Entity 

8  Matrix  Entity 

9  Unstructured  Entity 

10  Real,  Integer,  or  Complex 

If  the  PARMTYPE  is  entered  as  a  negative  value,  the  parameter  is  optional.  Note  that  character 
PARMTYPES  are  not  supported. 

Procedures 


For  procedures,  a  call  is  made  to  the  ASTROS  name  with  a  parameter  list  having  symbolic 
arguments  of  the  correct  types.  For  example,  if  a  module  has  the  following  parameters  (in  order) 
with  the  specified  data  t5q)es: 

3  Integers 
1  Logical 
1  Integer 
1  Relation 
1  Integer 
1  Optional  integer 

1  Optional  matrix 
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1  Matrix 
1  Optional  matrix 
1  Logical 
1  Matrix 

1  Optional  matrix 

2  Matrices 

1  Unstructured 

2  Optional  matrices 

1  Optional  logical 

2  Optional  matrices 

1  Optional  unstructured 

then  the  call  to  this  routine  is  coded  as: 


AROSNSDR  23 

102  1  1  1  4  1  7  1  -1  -8  8  -8  4  8  -8  8  8  9  -8  -8 

-4  -8  -8  -9 

C 

C  PROCESS  'AROSDR'  MODULE  -  SAERO  CONSTRAINT  SENS.  DRIVER 

C 

CALL  AROSDR  (  IP{1).  IP(2),  IP(3),  LP(4).  IP{5).  EP(6),  IP(7). 

1  IP(8),  EP(9),  EP(IO),  EP(ll),  LP(12),  EP(13), 

2  EP(14),  EP{15),  EP(16),  EP(17),  EP(18),  EP(19), 

3  LP(20),  EP(21),  EP(22),  EP(23)  ) 

END 

The  subscripted  array  elements  are  used  by  the  ASTROS  executive  to  pass  the  actual  parameter 
values.  The  subscripts  must  correspond  to  the  order  of  the  arguments  in  the  MAPOL  calling  list.  The 
following  array  names  are  used: 


IP  - 

Integer  Parameter 

RP  - 

Real  Parameter 

CP  - 

Complex  Parameter 

LP  - 

Logical  Parameter 

EP  - 

Entity  name 

This  method  passes  only  scalar  parameters  to  the  FORTRAN  driver.  No  mechanism  is  available  to  pass 
FORTRAN  arrays. 

Functions 


For  a  function,  the  resultant  value  is  returned  to  MAPOL  on  the  execution  stack.  To  accomplish 
this,  the  programmer  must  assign  the  numeric  function  result  to  the  FORTRAN  variables  TOUT,  ROUT, 
and  COOT  that  define  the  number  to  the  executive.  This  is  analogous  to  a  function  in  FORTRAN,  in  which 
the  value  must  be  assigned  to  the  function  name  within  the  function  umt. 
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A  numeric  value  is  defined  as  follows: 


lomid) 

Variable  type  key  with  the  same  definitions  as  in  PARMTYPE 

IOOT(2/3)  or 
ROUT(2,3)  or 

COUT 

Contain  the  actual  integer,  real  or  complex  variable  value.  These 
arrays  are  all  equivalenced: 

If  the  value  is  integer,  only  I  OUT  (2)  must  be  defined.  If  the  value  is  real,  only  ROUT  (2)  must  be 
defined.  If  the  value  is  complex,  then  either  GOUT  must  be  defined,  or  R0UT(2)  and  ROUT  (3)  must  be 
defined.  What  is  important  is  that  the  data  in  the  second  and  third  words  be  consistent  with  the  type  in 
lOUT(l). 

Further  if  the  function  operation  depends  on  the  t3^es  of  arguments  (as  do  the  FORTRAN 
generic  functions,  e.g.  MAX,  SIN),  the  array 

r  TP(I),  1=1,  NPARAM  ~  ~  I 

may  be  read  in  the  module  definition  code  to  determine  the  type  of  argument  passed.  The  parmtype 
definition  should  then  be  10  to  allow  any  type  to  be  passed.  TP  uses  the  same  definitions  as  PARMTYPE, 
except  the  actual  type  of  the  argument  is  stored.  In  other  words,  TP  contains  a  1,  2,  or  3  in  the  location 
associated  with  type  10  parameters,  depending  on  the  actual  type  passed  in  the  current  call. 


For  example,  if  the  sine  function  is  desired,  the  following  module  definition  would  be  used: 


SIN 

1 

100 

10 

c 

C 

SIN  -  RETURN  THE  SINE  OF  THE 

ARGUMENT 

C 

IF{ 

TP(1)  .LE.  2  )  THEN 
lOUT(l)  =  2 

IF  (  TP(1)  -EQ.  1  )  RP(1) 
ROUT (2)  =  SIN(RP{1)) 

ELSE 

lOUT(l)  =  3 

COUT  =  SIN(CP(1)) 

ENDIF 

=  ip(i) 

END  1 

3.2.1 .2  SYSGEN  Output  for  Modules 

The  data  defined  by  the  module  file  are  processed  and  the  results  are  stored  on  the  system 
database  in  two  entities.  The  first  is  a  relation  called  MODINDEX.  This  relation  has  two  attributes:  the 
first,  MODLNAME,  is  the  module  name  and  the  second,  ARGPONTR,  is  a  pointer  to  the  second  entity.  This 
second  entity  is  called  MODliARGS.  Each  record  of  this  unstructured  entity  contains  the  MODTYPE  and 
PARMTYPE  data  from  the  module  definition  file  for  a  particular  module.  Additionally,  the  output  of 
SYSGEN  includes  a  FORTRAN  subroutine  called  XQDRIV.  This  routine  is  the  module  driver  for  the 
ASTROS  execution  monitor.  It  must  be  compiled  and  linked  into  the  system  when  adding  or  changing 
module  definitions. 
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3.2.2.  Standard  Solution  Algorithm  Definition 

The  standard  multidisciplinary  solution  algorithm,  in  the  form  of  MAPOL  source  code  state¬ 
ments,  is  contained  in  a  sequential  file.  The  SYSGEN  program  reads  this  file  and  compiles  a  standard 
sequence.  The  results  of  the  compilation  are  stored  on  the  system  database  in  the  form  of  two  relations 
and  an  unstructured  entity.  The  first  relation  is  called  &MAPMEM  and  has  three  attributes:  ADDRESS, 
VARTYPE,  and  CONTENT.  This  relation  stores  the  execution  memory  map  for  the  standard  MAPOL 
sequence.  ADDRESS  is  an  integer  containing  the  address  of  the  variable,  VARTYPE  is  an  integer  denoting 
the  variable  type  and  CONTENT  is  a  two-word  integer  array  containing  the  current  value  of  the  variable. 

The  second  relation  output  from  the  compilation  of  the  standard  sequence  is  called  &MAPCOD  and 
has  three  attributes:  INSSEQ,  opcode,  and  ARGUMENT.  This  relation  contains  the  ASTROS  machine 
instructions  that  represent  the  compiled  MAPOL  sequence.  iNSSEQ  is  an  integer  containing  the  instruc¬ 
tion  sequence  nvimber,  opcode  is  the  machine  operation  code  to  determine  the  action  to  be  taken,  and 
ARGUMENT  is  the  argument  to  the  operation  --  either  a  memory  address  of  an  immediate  operand. 

The  final  output  from  the  standard  algorithm  definition  is  not  directly  related  to  the  compilation 
of  the  sequence.  It  is  a  relation  called  &MAPSOU  containing  the  standard  sequence  source  code  statements 
verbatim.  This  is  stored  on  the  system  database,  allowing  the  user  to  edit  the  standard  sequence  to 
generate  a  new  MAPOL  program  which  directs  the  ASTROS  procedure.  The  relation  has  two  attributes: 
LXNENO  and  SOURCE.  LINS2T0  is  an  integer  containing  the  line  number  and  source  is  a  string  attribute 
containing  the  80-character  source  code  line. 

3.2.3.  Bulk  Data  Template  Definition 

The  ASTROS  bulk  data  decoding  module  (ifp)  is  driven  by  templates  that  are  stored  on  the 
system  database  during  system  generation.  The  template  format  for  ifp  was  adopted  to  allow  for  easy 
installation  of  new  bulk  data  entries  and  for  easy  modification  of  existing  bulk  data  entries.  The  sequen¬ 
tial  file  used  by  SYSGEN  contains  the  bulk  data  templates  for  all  the  bulk  data  inputs  defined  to  the 
ASTROS  system  in  arbitrary  order. 

3.2.3.1  The  File  Format 

The  template  definition  file  has  the  following  format: 

MAXSET  (18) 

NLPTMP  (18) 

TEMPLATE  1 
TEMPLATE  2 


MAXSET  is  the  maximum  number  of  template  sets  used  to  define  one  bulk  data  input.  Currently, 
this  value  is  five,  nlptmp  is  the  number  of  lines  in  each  template  set.  Cmrently  there  are  six  lines  in 
each  set.  A  bulk  data  template  therefore  consists  of  1,2,3, . .  .maxset  template  sets,  each  of  which 
consist  of  NLPTMP  template  lines  which  define  the  structure  of  the  input  entry.  The  defimtion  includes 
the  field  size,  the  field  label,  the  field  data  type,  the  field  defaults,  the  field  checks,  the  field  database 
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loading  position  and,  if  necessary,  a  list  of  relational  attributes.  The  structure  of  the  template  set  is  as 
follows: 


BULK  DATA  ENTRY  LABEL 
FIELD  DATA  TYPES 
DEFAULT  VALUES 
ERROR  CHECKS 
FIELD  LOADING  POSITION 
DATABASE  ENTITY  DEFINITION 


A  typical  bulk  data  entry  template  is: 


CQt7AD4  |EID 

|PID 

iGl 

1 G2 

CHAR  INT 

INT 

INT 

INT 

DEFAULT 

EID 

CHECKS  GT  0 

GT  0 

GT  0 

UG  2 

1 

2 

3 

4 

CQUAD4  EID 

PIDl 

GRIDl 

GRID2 

+CQUAD4 1 

|TMAX 

|T1 

|T2 

CHAR 

REAL 

REAL 

REAL 

DEFAX7LT 

1.E4 

CHECKS 

GE  0. 

GE  0. 

GE  0. 

10 

11 

12 

OFFSTO 

TMAX 

THICKl 

|G3 

|G4 

|TH 

|ZOFF 

|CONT  1 

INT 

INT 

INT/REALREAL 

CHAR 

0. 

0. 

UG  3 

UG  4 

GT  0 

5 

6 

7 

9 

GRID3 

GRID4 

CIDl 

THETA 

|T3 

|T4 

1 

1 

REAL 

REAL 

GE  0. 

GE  0. 

13 

-14 

TH1CK2 

THICK3 

THICK4 

$ 

The  lABEL  Template  Set  Line 


The  first  seven  columns  of  the  first  template  set  line  define  the  name  of  the  input  data  entry.  The 
eighth  column  is  reserved  for  a  field  mark,  ”  | ",  Columns  9  through  72  define  the  field  labels  and  these  are 
separated  by  the  field  mark  "  | Columns  73  through  79  indicate  to  the  decoding  routines  if  a  continu¬ 
ation  card  is  supported  for  this  entry.  On  the  first  template  set’s  label  line  (the  template  set  for  the 
parent  line  of  the  bulk  data  entry),  the  character  string  cont  indicates  that  a  continuation  line  is 
supported.  Otherwise,  these  columns  are  ignored  and  a  continuation  will  not  be  allowed  for  the  entry 
defined  by  this  template.  A  continuation  template  set’s  LABEL  line  differs  firom  the  parent  template  in 
that  the  chairacter  string  etc  can  be  used  in  columns  73  through  79  of  the  continuation  template  set’s 
LABEL  line  to  indicate  an  open  ended  entry  having  a  repeating  continuation.  In  this  case,  the  same 
continuation  template  will  be  used  to  decode  all  remaining  continuation  entries.  For  free  format  input, 
the  continuation  entries  must  have  the  input  extend  to  the  third  field  (the  second  data  field).  Also,  note 
that  ALL  template  set’s  LABEL  lines  must  have  a  field  mark  in  column  80  to  end  the  line. 


The  FIELD  DATA  TYPE  Template  Set  Line 


The  FIELD  DATA  TYPE  Template  Set  Line  defines  the  t3rpes  of  data  that  are  allowed  for  each 
field.  Possible  data  types  include:  blank,  INT  (integer),  REAL  (real),  char  (character),  INT/REAL  (integer 
or  real),  INT/CHAR  (integer  or  character),  and  REL/CHAR  (real  or  character).  The  data  type  definition 
characters  (i.e.,  INT)  must  be  left  justified  in  the  fields. 
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The  DEFAtTLT  Temnlate  Set  Line 


The  DEFAULT  template  set  line  defines  the  default  values  of  the  fields.  If  the  input  data  entry 
has  an  empty  field,  the  default  value  will  be  used  as  the  input.  All  values,  like  the  data  types,  must  be 
left  justified  in  the  fields.  Three  special  cases  for  default  values  have  been  incorporated  into  the  decoding 
routines.  The  first  is  the  case  of  a  special  user  input  entry  to  define  the  defaults  for  a  template.  In  this 
case  the  user  supplied  values  will  be  substituted  for  the  normal  default  values.  The  BAH.OR  and  6RDSET 
entries  are  examples  of  special  inputs  used  to  define  the  defaults.  The  addition  of  any  other  special  inputs 
lihe  these  requires  program  changes  in  routines  XFPBD,  BDMERG,  and  XFFDEC.  Another  special  case  is  in 
the  referral  to  another  field  of  the  same  template  to  obtain  the  default  value.  Referral  values  can  exist  for 
all  data  types  except  character  (CHAR)  data.  In  the  case  of  a  default  referral,  the  current  template  set 
LABEL  line  is  searched  for  the  label  referred  to  and,  if  the  label  string  is  not  found,  all  other  template 
sets,  starting  at  the  parent  template  set,  are  searched  for  the  string.  When  the  string  is  found,  the 
corresponding  entry  field  is  decoded  to  obtain  the  default  value.  An  example  of  a  referral  is  the  PXD  field 
of  the  CQUAD4  card  template.  The  third  special  case  for  defaults  is  the  use  of  a  multipher  for  an  integer 
defardt  referral.  This  is  only  valid  for  integer  type  data  and  the  presence  of  a  multiplier  is  defined  by  an 
asterisk  For  example,  3*ndn,  where  NDNis  the  label  associated  with  another  integer  data  field. 

The  ERROR  CHECK  Template  Set  Line 

The  ERROR  CHECK  template  set  line  directs  data  checking  for  the  decoded  fields.  Each  error  check 
specifies  both  the  type  of  check  and  the  check  value.  The  available  check  types  depend  on  the  data  type 
(for  example.  Integer,  Real,  or  Character).  Checks  that  are  currently  encoded  are  shown  in  Table  1. 

If  additional  checks  are  needed,  subroutiae  XNTCHK  must  be  modified  for  integer  checks,  RELCHK 
must  be  modified  for  real  checks  and  CHRCHK  must  be  modified  for  character  checks. 

When  two  check  values  are  needed,  as  for  the  XB  and  EB  checks,  the  first  is  located  on  the  ERROR 
CHECK  template  set  line  and  the  second  is  located  in  the  same  column  position  on  the  fxeld  loadxng 
POSXTXON  line. 

Tht>  igTF.T.r>  LOADING  POSITXON  Template  Set  Line 

The  FIELD  LOADING  POSXTXON  template  set  line  is  used  to  place  the  converted  data  into  the 
database  loading  array.  The  sequence  of  the  numbering  is  dependent  on  three  conditions.  The  first  is  the 
existence  of  CHAR  data  on  the  card.  In  this  case,  two  hollerith  single  precision  words  will  be  used  to  store 
an  eight  character  input  and  the  numbering  must  account  for  the  two  words.  The  second  condition  is  the 
sequence  of  the  attribute  list  for  a  relational  bulk  database  entity.  In  this  case  the  loadmg  sequence  is 
determined  by  the  sequence  of  the  attribute  list.  The  third  condition  occurs  when  a  multiple  data  type 
field  is  present,  (e.g.,  REL/CHAR).  In  this  case  the  first  variable  type  is  loaded  at  the  given  value  and  the 
second  variable  type  is  loaded  in  the  next  word(s).  Again  this  must  be  accounted  for  in  the  numbering 
sequence.  Finally,  when  a  negative  integer  value  is  given  as  the  loading  position,  the  database  loading 
array  will  be  loaded  onto  the  database  if  input  errors  have  not  occurred.  A  negative  value  should  be  used 
on  the  field  associated  with  the  last  attribute  of  the  relational  projection.  At  least  one  negative  loading 
position  must  be  defined. 


65 


Table  1.  Bulk  DataTemplate  Error  Checks 


CHECK 

TYPE 

DATA 

TYPE 

MEANING 

blank 

all 

No  check 

GT 

Xnt ,Real 

Greater  than 

6E 

Xnt,Real 

Greater  than  or  equal 

NE 

Xnt,Real 

Not  equal 

LT 

Xnt,Real 

Less  than 

LE 

Xnt,Real 

Less  than  or  equal 

EQ 

All 

Equal 

EB 

Xnt,Real 

Exclusive  in  between 

IB 

Xnt,Real 

Inclusive  in  between 

EOR 

Xnt ,Real 

Either  or 

GEP 

Int,Real 

Greater  than  or  equal  to  the  previous  value 

UG 

Xnt 

Unique  grid 

EUG 

Xnt 

Empty  or  unique  grid 

COMP 

Xnt 

A  set  of  component  numbers 

HZD3 

Xnt 

PSHELL  MID3  material  check 

MID4 

Xnt 

PSHELLMID4  material  check 

SA 

Xnt 

SPCADD,  MPCADD  combination  check 

EXGG 

Int 

Grid  check  on  the  EIGl  family  of  input  entries 

EXGC 

Xnt 

Component  check  on  the  ElGl  family  of  Input 
entries 

X12 

Int 

112  check  on  the  CBAR  entry 

MATG 

Xnt 

E  and  G  check  on  the  MAT1  entry 

NU 

Real 

Check  E,  G  and  NU  for  the  MAT1  entry 

IDES 

Real 

Design  variable  range  check 

F.T. 

Char 

Failure  theory  for  the  PCOMP  entry 

YORN 

Char 

Yes  or  No 

PTYP 

Char 

ETYP 

Char 

Element  type  for  the  ELI  ST  entry 

NORM 

Char 

Normalization  method  for  the  EIGi  family  of 
input  entries 

CMETH 

Char 

Solution  method  for  the  EIGC  entry 

RMETH 

Char 

Solution  method  for  the  EIGR  entry 

li,0. 

Char 

Lamination  option  for  PCOMPi  entries 

ACMP 

Char 

Component  type  for  airfoil  and  CAER06 
entries 

BCMP 

Char 

Component  type  for  BODY  and  PAER06 
entries 

BTYP 

Char 

Body  orientation  type  for  the  PAER06  entry 

CONV 

Char 

Conversion  factor  quantity  type  for  the 
CONVERT  entry 

CTYP 

Char 

Upper  or  Lower  bound  constraint  check  for 
DCONXXX,  entries 

FMETH 

Char 

Rutter  analysis  method  for  the  flutter  entry 

DTYPE 

Char 

Damping  type  for  the  TABDMP1  entry 

MPREC 

Char 

Matrix  precision  for  DMI  and  DMIG  entries 

MFORM 

Char 

Matrix  form  for  DMI  and  DMIG  entries 

FFTl 

Char 

Interpolation  method  for  the  FFT  entry 

CHECK 

TYPE 

DATA 

TYPE 

MEANING 

imsm 

Output  format  selector  for  the  FFT  entry 

j  MASSF 

ETYPL 

Char 

Element  name  for  the  ELEMLIST  and 

dcontHK  entries 

CCX 

Xnt 

Material  property  defaulting  check  for  the 
PCOMP  entry 

CCRl 

Real 

Laminae  thickness  defaulting  check  for  the 
PCOMP  entry 

CCR2 

Real 

Laminae  orientation  angle  defaulting  check 
for  the  PCOMP  entry 

Real 

Laminae  orientation  angle  and  thickness 
defaulting  checkfor  PCOMPI  and  PC0MP2 
entry 

GTZOB 

Int , Real 

Greater  than  zero  or  blank 

GEZOB 

Xnt , Real 

Greater  than  or  equal  to  zero  or  blank 

ULC 

Xnt 

lUST,  ILST.  and/or  ICAM  check  for  the 
AIRFOIL  entry 

LAMCHK 

Xnt 

DCONLAM/DCONLMN  laminate  definition 
check 

PLYNORS 

Xnt 

DCONLAM/DCONPMN  ply  definition  check 

NEBIiK 

Char 

Not  equal  to  blank 

ETYPC 

Char 

Element  name  for  the  DCONFTP  and 
DCONTWP  entries 

Char 

Property  name  for  the  DCONFTP  and 
DCONTWP  entries  j 

ETYPS 

Char 

Element  name  for  the  DCONEP  and! 
DCONVM  entries 

PTYPS 

Char 

Property  name  for  the  DCONEPP  and 
DCONVMP  entries 

STYPE 

Char 

Control  surface  symmetry  type 

Char 

TRIM  type  j 

XJM 

Char 

UM  flag  for  RBEi  entries  j 

TRMACC 

Char 

Acceleration  label  check  for  DCONSCF  | 
entry  | 

SCFPRM 

Char 

Parameter  label  check  for  DCONSCF  entry  j 

SCFUNXT 

Char 

Unit  label  check  for  DCONSCF  entry  I 

VTYPE 

Char 

Velocity  type  check  for  DCONFLT  entry  I 

DCNTYP 

Char 

Constraint  type  check  for  DCONLIST  entry  I 

FLTFXT 

Char 

Curve  fit  type  check  for  FLUTTER  entry  || 

j  LAMCHK 

Char 

DCONLAM/DCONLMN  laminate  check  | 

The  DATABASE  ENTITY  DEFINITION  Template  Set  Line 


The  DATABASE  ENTITY  DEFINITION  template  set  line  names  the  database  entity  to  be  loaded 
in  the  first  eight  columns  of  the  parent  template  set,  and  the  database  attribute  list  for  relational  entities 
(Columns  9-72),  of  the  parent  template  set.  Column  80  is  reserved  for  a  map-end  character  ($).  Tfie 
map-end  character  indicates  the  end  of  the  template,  and  so  must  occur  only  on  the  last  database  entity 
definition  line  for  the  final  set  of  the  template. 


3.2.3.2  SYSGEN  Output  for  Template  Definitions 


The  SYSGEN  outputs  consist  of  an  unstructured  entity  called  systmplt  which  contains  the 
templates  and  a  relation  called  tmppoint  which  allows  efficient  access  to  particular  templates.  The 
SYSTMPLT  entity  contains  one  RECORD  for  each  bulk  data  template  in  the  order  it  appears  in  the  input 
template  definition  file.  Therefore,  the  records  are  of  variable  length  with  the  longest  record  contain¬ 
ing  80  characters  for  each  of  MAXSET  template  sets  of  NLPTMP  lines.  The  TMPPOINT  relation  has  two 
attributes:  card  and  RECORD.  CARD  is  an  eight  character  string  attribute  containing  the  name  of  the  bulk 
data  entry  and  RECORD  is  the  number  where  the  template  is  stored  in  systmplt. 

3.2.4.  Relational  Schema  Definition 


Each  relational  database  entity  requires  a  SCHEMA  that  defines  its  data  attributes.  A  sequential 
file,  containing  character  data,  is  used  to  define  these  schemata.  For  each  relation  there  is  a  list  of  the 
attribute  names,  their  types,  and,  if  they  are  arrays  or  character  data,  their  length.  The  details  of  this  file 


are  described  below: 


3.2.4.1  The  File  Format 


The  schema  definition  file  is  organized  as  shown  below: 


REL(l)  ENTRY 
REL(2)  ENTRY 


REL(NREL)  ENTRY 


Each  RELATION  entry  has  the  following  form  of  firee  field  input.  Each  input  may  appear  anywhere 
on  the  line  separated  by  one  or  more  blanks  except  "RELATION"  and  "end". 

RELATION  RELNAME 
ATTRNAME  ATTRTYPE  ATTRLEN 

END  _ _ _ _ _ _ _ 


where 


RELATION 

RELNAM 


is  the  keyword  "RELATION"  which  signifies  that  a  new  RELATION  schema 
follows.  Must  begin  in  column  1. 

is  the  name  of  the  RELATION;  it  may  be  one  to  eight  characters  beginning 
vrith  a  letter. 
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ATTRNAME 


is  the  name  of  the  attribute;  it  may  be  one  to  eight  characters  beginning 
with  a  letter. 

ATTRTYPE  is  the  t3Tpe  of  the  attribute  selected  from: 

’INT’  Integer 

’KiNT’  Keyed  Integer 

’aint’  Array  of  Integers 

’RSP’  Real,  single  precision 

’arsp’  Array  of  real,  single  precision 

’rdp’  Real,  double  precision 

’STR’  Character  string 

’Kstr’  Keyed  character  string 

ATTRLEN  is  the  optional  length  of  the  Attribute.  If  it  is  of  type  aint,  arsp,  ARDP, 

STR,  or  KSTR,  the  length  is  not  optional.  For  other  types,  it  should  be  zero  or 
not  present. 

END  is  the  ke3word  "END"  which  signifies  the  END  of  the  RELATION  schema. 

3.2A.2  SYSGEN  Output  for  Relations 

The  data  defined  by  the  RELATION  schema  file  are  processed  and  the  results  are  stored  in  two 
entities  on  the  system  database.  The  first  is  a  RELATION  called  relindex.  This  entity  has  an  attribute 
RELTNAME  containing  the  name  of  the  RELATION  and  an  attribute  SCHMPNTR  which  is  an  integer  pointer 
to  an  imstructured  entity  called  RELSCHEM.  The  RELSCHEM  entity  contains  a  fist  of  attribute  names, 
types  and  lengths  for  each  RELATION.  Each  RELATION  has  one  tuple  in  the  relindex  relation  and  one 
RECORD  in  the  relschem  entity.  Each  relschem  record  consists  of  a  four-word  entry  for  each  attribute: 
two  hoUerith  words  containing  the  attribute  name,  one  hollerith  word  containing  the  attribute  type  and 
an  integer  word  containing  the  attribute  length. 

3.2.5.  Error  Message  Text  Definition 

The  text  of  ASTROS  run  time  messages  is  stored  and  maintained  on  a  sequential  file  which  is 
used  during  system  generation  to  create  SYSDB  entities  for  use  by  the  ASTROS  message  writer  utility 
module.  There  are  two  reasons  for  maintaining  the  message  text  on  an  external  file  (and  on  SYSDB). 
First,  the  storage  of  message  text  within  the  functional  modules  would  use  a  large  amount  of  memory 
during  execution.  Second,  storing  the  messages  together  in  an  external  file  allows  for  easier  maintenance 
and  aids  in  avoiding  needless  duplication  m  message  texts.  The  messages  stored  on  SYSDB  from  this  file 
are  used  by  the  ASTROS  utility  XJTMWRT  to  build  error  messages  during  execution. 

3.2.5.1  The  File  Format 

The  message  text  file  is  organized  as  follows: 

^MODULE  1  {<header>) 
messages 

*MODULE  2  {<header>} 
messages 

^MODULE  3  {<header>} 
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*MODULE  <n>  {<header>} 

The  header  is  an  optional  label  of  any  length  or  content  up  to  120  characters  that  typically  would 
describe  the  relationship  among  the  messages  for  the  specified  module.  In  this  way,  messages  that  are 
logically  related  (for  example,  all  error  conditions  from  the  IFP  module)  can  be  grouped  together  for 
simplified  maintenance.  The  module  number  <n>  is  a  imique  integer  identifying  the  base  module  number 
for  the  group  of  error  messages.  It  need  not  be  consecutive,  which  allows  for  randomly  numbered  mod¬ 
ules. 


The  format  of  the  message  text  is  as  follows: 

I  'message  text  $  more  text  $  . . . '  I 

the  string  is  enclosed  in  a  single  quotation  marks  because  the  message  will  be  used  as  a  character  string 
in  a  FORTRAN  write  statement.  The  $  (dollar  sign)  is  used  by  the  UTMWRT  utility  to  place  character 
arguments  into  the  string.  For  example, 

I  '$  ELEMENT  $  IS  ATTACHED  TO  SCALAR  POINT  $.'  I 

would  appear  for  CTRMEM  element  100  attached  to  scalar  point  1001: 

r  CTRMEM  ELEMENT  100  IS  ATTACHED  TO  SCALAR  POINT  1001.  I 

If  the  user  wishes  the  message  to  carry  over  to  the  next  output  record,  the  FORTRAN  format  record 
terminator  (/)  can  be  used  outside  the  quotation  marks  to  cause  a  record  advance.  For  example. 

I  'THIS  IS  ON  LINE  1'/'  THIS  IS  ON  LINE  2.'  I 

Q-jjjiTi’gii'tly  there  is  an  implementation  limit  of  128  characters  for  the  length  of  the  message  text  after 
including  the  arguments.  Further  details  are  given  in  the  documentation  for  the  UTMWRT  utihty  module. 

3.2.5.2  SYSGEN  Output  for  Error  Message  Text 

The  data  in  the  message  file  are  used  to  create  two  system  database  entities.  The  first  is  an 
indexed  imstructured  entity  called  ERRMSG.  This  entity  contains  one  line  of  the  message  text  file  in  each 
record.  The  second  is  an  unstructured  entity  called  ERMSGPNT  which  has  one  record.  That  record  has  two 
words  for  each  module  defined  in  the  message  file.  Those  words  are  the  module  number  <n>  and  the 
record  number  of  the  errmsg  record  containing  the  module  header.  These  are  used  by  the  dtmwrt  to 
position  to  the  proper  message  text  when  called. 
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3.3.  GENERATION  OF  THE  ASTROS  SYSTEM 


Following  the  execution  of  the  SYSGEN  program  the  system  installation  proceeds  to  the  genera¬ 
tion  of  the  ASTROS  executable  image.  As  indicated  in  Section  3.2,  the  SYSGEN  program  writes  a 
FORTRAN  program  called  XQDRiv  which  must  be  linked  with  the  remainder  of  the  source  code  to  form 
the  ASTROS  system.  It  is  this  FORTRAN  program  which  provides  the  flexible  interface  between  the 
ASTROS  executive  and  the  remainder  of  the  ASTROS  modules.  To  generate  the  ASTROS  system, 
therefore,  it  is  essential  to  execute  the  SYSGEN  program  as  a  first  step. 

The  SYSGEN  execution  is  only  required  once  to  generate  the  standard  version  of  ASTROS.  This 
is  the  version  that  is  defined  by  the  dehvered  set  of  SYSGEN  input  files  described  in  Section  3.2.  If, 
however,  the  users  of  the  system  at  a  particular  installation  desire  to  insert  additional  modules,  the 
SYSGEN  program  must  be  re-executed  to  recreate  the  XQDRiv  submodule.  The  users  may  also  want  to 
modify  other  SYSGEN  inputs  to  update  the  system  database  to  include  additional  input  entries  or  new 
relational  schema.  These  changes  also  reqxiire  the  re-execution  of  the  SYSGEN  program  (to  update  the 
system  database)  but  do  not  require  an  update  of  the  ASTROS  system.  For  most  purposes,  only  the 
module  definition  file  described  in  Section  3.2.1  requires  that  the  ASTROS  executable  image  be  recre¬ 
ated. 
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4.  EXECUTIVE  SYSTEM 


The  ASTROS  executive  system,  as  described  in  Section  3  of  the  Theoretical  Manual,  may  be 
viewed  as  a  styUzed  computer  with  fom:  components:  a  control  unit,  a  high  level  memory,  an  execution 
monitor  and  an  Input/Output  subsystem.  The  first  three  components  comprise  the  executive  system 
modules  while  the  I/O  subsystem  is  embodied  in  the  database.  The  ASTROS  modules  that  comprise  the 
executive  system  perform  tasks  to  establish  the  ASTROS/host  interface,  initiate  the  execution  and,  upon 
completion  of  the  MAPOL  instructions,  terminate  the  execution.  These  modules  also  compile  the  MAPOL 
sequence,  if  necessary,  and  initiate  the  execution  monitor  that  interprets  the  IMAPOL  instructions  guid 
irig  the  execution.  This  section  documents  the  modules  of  the  ASTROS  executive  system. 

The  typical  user  of  ASTROS  need  not  be  familiar  with  the  executive  system  modules  since  their 
execution  path  does  not  have  the  flexibility  that  is  available  for  the  engineering  modules.  The  executive 
modules,  however,  are  important  from  the  viewpoint  of  the  system  manager  and  the  program  developer 
for  several  reasons.  First,  problems  with  the  machine  dependent  library  on  a  new  host  system  often  show 
up  during  the  executive  modules’  initialization  tasks.  The  executive  system  modules  are  also  important 
in  understanding  the  treatment  of  the  user’s  input  data  stream.  To  isolate  the  use  of  external  files  to  the 
executive  system,  for  example,  the  prepas  executive  module  reads  the  input  data  stream  and  loads  those 
portions  that  de^  with  the  MAPOL,  Solution  Control  and  Bulk  Data  packets  to  the  database.  The  system 
manager,  therefore,  may  find  it  useful  to  study  the  nature  of  the  executive  modules  and  their  interrela¬ 
tionships  to  better  iinderstand  the  implementation  of  the  ASTROS  architecture. 


Executive  System  Module:  ASTROS 
Entry  Point:  ASTROS 


PURPOSE: 

ASTROS  is  the  main  entry  point  for  the  ASTROS  procedure.  It  controls  the  execution  path  through  the 
executive  system  modules. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

None 

Method: 

The  ASTROS  routine  first  sets  a  flag  to  tell  the  executive  modules  that  subsequent  calls  are  associated 
with  the  ASTROS  procedure  rather  than  with  the  SYSGEN  program.  This  flag  is  required  since  the 
compiler  and  other  executive  routines  are  shared  between  the  two  programs  and  require  sightly  different 
execution  paths.  The  machine  dependent  initialization  routine,  XXINIT,  is  then  called  to  perform  the 
initiahzation  tasks  required  on  the  current  host  system.  The  initialization  is  completed  by  zeroing  the 
execution  monitor’s  stack  length,  calling  the  machine  independent  initialization  routine,  XQXNIT, 
labeling  the  output  listing  and  the  starting  the  timing  summary 

The  PREPAS  module  is  then  called  to  read  the  user’s  input  data  stream.  On  return  fi'om  PREPAS,  the 
MAPOL  compiler  is  called  if  a  MAPOL  compilation  is  required.  Finally,  the  execution  monitor,  XQTMON, 
is  called  to  interpret  the  ASTROS  machine  instructions  representing  the  compiled  MAPOL  sequence. 
AH  subsequent  activities  in  the  ASTROS  execution  are  controlled  by  this  module  until  all  the  MAPOL 
instructions  have  been  completed.  Upon  retinn  from  XQTMON,  the  main  driver  terminates  the  execution 
by  writing  the  closing  label,  calling  the  xqends  module  to  close  the  database,  dumping  the  timing 
summary  and  performing  any  other  closing  tasks. 

The  engineering  modules  (addressed  by  the  execution  monitor)  may  also  terminate  the  execution  of  the 
system.  In  these  cases,  the  general  application  utility  module,  utexit,  is  used  since  this  routine 
assumes  that  an  error  exit  has  occinred.  utexit,  however,  also  calls  the  xqends  executive  module  to 
assure  clean  termination  of  all  executions. 

Design  Requirements: 

None 

Error  Conditions: 


None 


Executive  System  Module;  XQINIT 
Entry  Point:  XQINIT 


PURPOSE: 

To  perform  machine  independent  system  initialization  tasks. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XQINIT 

Method: 

This  routine  completes  the  page  titling  information  on  the  TITLE  line  used  by  the  UTPAGE  utility.  The 
ASTROS  version  number  is  placed  in  TITLE  (which  is  in  the  /OUTPUT2/  common  block)  in  characters 
88  through  107.  The  current  date  is  obtained  using  XXDATE  and  placed  in  characters  109  to  117.  The 
page  number  label  is  then  placed  in  characters  120  to  121.  Thus,  the  page  number  itself  is  left  to  fit  in 
characters  123  to  128. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Executive  System  Module:  PREPAS 

Entry  Point:  PREPAS 

PURPOSE: 


lb  perform  the  first  pass  through  the  user’s  input  data  stream,  to  initialize  the  open  core  memory 
manager  and  to  attach  the  scratch  and  system  databases. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CAIiL  PREPAS  (  MAPFL6,  S0LFL6,  BLKFLG  ) 

MAPFLG  Integer  flag  denoting  the  presence  or  absence  of  a  MAPOL  packet  in  the 

input  data  stream  (Output) 

=  0  if  no  MAPOL  packet 

=  1  if  a  MAPOL  packet  exists  in  the  input  stream 

SOLFLG  Integer  flag  defined  like  MAPFLG  denoting  the  presence  or  absence  of  a  So¬ 

lution  Control  packet  in  the  input  data  stream  (Output) 

BLKFLG  Integer  flag  defined  hke  MAPFLG  denoting  the  presence  or  absence  of  a 

Bulk  Data  packet  in  the  input  data  stream  (Output) 

Method: 

This  routine  performs  the  first  pass  over  the  user’s  input  data  stream,  performs  actions  based  on  the 
ASSIGN  DATABASE,  DEBUG  and  MAPOL  EDIT  command  inputs  and  prepares  MAPOL,  solution  control 
and  bulk  data  inputs  for  access  by  the  appropriate  modules.  The  order  of  operations  is  crucial  and  can 
be  summarized  as  follows: 

1.  The  debug  packet  must  be  processed  first  since  the  debug  flags  can  afiect  the  memory  management 
system. 

2.  Immediately  following  the  debug  packet,  the  memory  manager  must  be  initiahzed,  and  the  scratch 
(run-time)  database  (based  on  the  ASSIGN  database  entry)  and  the  system  database  must  be 
attached,  in  that  order.  The  order  is  dictated  by  the  requirement  that  the  memory  manager  be 
available  for  the  DBINIT  calls  and  the  scratch  database  must  be  allocated  before  the  system 
database.  The  system  database  must  be  allocated  in  order  to  process  the  MAPOL  packet  (which 
may  apply  EDIT  operations  to  the  standard  MAPOL  sequence  stored  on  the  system  database). 

Once  the  ASSIGN  database  and  debug  packets  are  processed,  the  remaining  packets  could  be  ordered 
in  any  fashion,  but  a  fixed  sequence  of  MAPOL,  solution  control  and  bulk  data  packets  has  been  imposed. 

The  procedure  used  in  PREPAS  is  to  read  the  input  stream  one  80-character  record  at  a  time.  The  first 
nonblank  records  must  be  the  ASSIGN  DATABASE  entry.  The  corresponding  records  are  set  aside  in 
ASNCRD  for  use  after  the  debug  packet  is  processed.  After  the  ASSIGN  DATABASE  entry  has  been 
encountered,  each  input  record  is  read  and  searched  to  see  if  one  of  the  input  stream  keywords  appears 
in  the  first  eight  characters  following  the  first  nonblank  character.  The  keywords  are: 

1.  DEBUG  denoting  the  start  of  the  debug  packet 

2.  MAPOL  denoting  the  start  of  the  MAPOL  packet  containing  a  complete  new  MAPOL  sequence 
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3.  EDIT  denoting  the  start  of  the  MAPOL  packet  containing  edit  commands  to  be  applied  to  the 
standard  sequence 

4.  SOLUTION  denoting  the  start  of  the  solution  control  packet 

5.  "begin_"  denoting  the  start  of  the  bulk  data  packet.  Note  the  trailing  blank  after  BEGIN  and  the 
absence  of  the  optional  BULK  ke3rword. 

6.  ENDDATA  denoting  the  end  of  the  bulk  data  packet 

7.  INCLUDE  naming  the  secondary  file  from  which  to  read  the  input 

Note  that  all  the  keywords  except  ENDDATA  and  INCLUDE  mark  the  beginning  of  a  new  packet.  The 

INCLUDE  ke3rword  does  not  change  the  current  packet  and  enddata  marks  the  end  of  the  valid  input. 

If  the  current  record  is  one  of  the  keyword  records,  flags  are  set  to  indicate  that  a  new  packet  has  been 

initiated  or,  for  include,  the  include  file  is  opened  and  processing  continues  with  the  new  input  file 

until  it  is  exhausted.  Records  that  are  not  kesrword  records  are  processed  as  follows: 

1.  DEBUG  packet  records  are  sent  to  the  CRKBUG  utility  to  interpret  the  debug  commands  and  set  the 
executive  system  debug  command  flags  in  the  /EXEC02/  common  and  set  the  other  debug  command 
flags  by  UTSFLG  to  activate  nm  time  debugs. 

2.  MAPOL  packet  records  representing  a  replacement  MAPOL  sequence  are  written  to  the  unstruc¬ 
tured  entity  &MAPLPKT  for  processing  in  the  MAPOL  module. 

3.  MAPOL  packet  records  representing  an  EDIT  of  the  standard  sequence  are  passed  to  the  mapedt 
subroutine  to  be  interpreted.  The  resultant  MAPOL  sequence  is  written  to  the  unstructiu-ed  entity 
&MAPLPKT  for  processing  in  the  MAPOL  module. 

4.  SOLUTION  packet  records  are  written  to  the  unstructured  entity  &SOLNPKT  for  processing  in  the 
SOLUTION  module. 

5.  Bulk  Data  packet  records  are  written  to  the  unstructured  entity  &bkdtpkt  for  processing  in  the 
IFP  module. 

Design  Requirements: 

None 

Error  Conditions: 

1.  Input  stream  does  not  begin  with  an  ASSIGN  DATABASE  entry. 

2.  An  input  stream  keyword  appears  out  of  order. 

3.  An  ENDDATA  statement  appears  outside  the  bulk  data  packet. 

4.  No  filename  was  found  on  an  INCLUDE  statement. 

5.  INCLTJDE  file  cannot  be  opened. 

6.  Input  record  lies  outside  any  input  packet  (typically  following  an  enddata). 

7.  FORTRAN  read  error  on  the  primary  input  stream  or  included  file. 

8.  An  INCLUDE  statement  appearing  in  a  included  file. 
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Executive  System  Module;  MMINIT 
Entry  Point:  MMINIT 


PURPOSE: 

To  initialize  the  memory  manager. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MMINIT  (  SIZE  ) 

SIZE  The  number  of  single  precision  words  in  open  core  (Integer,  Input) 

Method: 

This  routine  estabhshes  the  initial  block  headers  for  open  core  memory.  A  block  header  is  written 
representing  one  free  block  of  SIZE  words  less  those  required  for  the  block  header.  The  block  header  is 
either  six  or  eight  words  depending  on  whether  the  memory  debug  has  been  selected  by  the  user  in  the 
input  stream.  The  size  must  correspond  to  the  actual  declared  length  of  the  open-core  common  block 
/MEMORY/. 

Design  Requirements: 

None 

Error  Conditions: 

None 


76 


Executive  System  Module:  DBINIT 

Entry  Point:  DBINIT 

PURPOSE: 

To  initialize  the  processing  for  a  database. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBINIT  (  DBNAME,  PASSVTO,  STAT,  RW,  USRPRM  ) 


DBNAME 

The  database  name  (Character,  Input) 

PASSWD 

The  database  password  (Character,  Input) 

STAT 

The  database  status  (Character,  Input) 

One  of  OLD,  NEW,  save,  perm  or  TEMP 

RW 

Read/Write  status  (Character,  Input) 

One  of  RO  or  R/W 

USRPRM 

Installation  dependent  user  parameters  (Character,  Input) 

Method: 

This  routine  opens  the  named  database  for  access.  It  performs  any  machine  and  installation  dependent 
processing  by  accessing  the  database  machine  dependent  library  routines  DBMDCX  and  DBMDIX.  All  the 
in-core  buffers  required  for  subsequent  database  access  are  allocated  using  the  database  memory 
management  routines. 

Design  Requirements: 

1.  The  first  to  DBINIT  must  define  the  run-time  or  scratch  database.  Any  other  databases  may 
then  be  initiahzed. 

Error  Conditions: 

1.  Any  error  conditions  on  the  file  operations  occuring  in  DBINIT  will  terminate  the  execution. 

Entry  Point:  DBCINI 

PURPOSE: 

To  initiahze  the  processing  for  a  database  and  return  a  status  code  rather  than  terminate  on  error. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBCINI  {  DBNANE,  PASSWD,  STAT,  RW,  USRPRM,  ISTAT  ) 

DBNAME  The  database  name  (Character,  Input) 
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PASSWD  The  database  password  (Character,  Input) 

STAT  The  database  status  (Character,  Input) 

One  of  OLD,  NEW,  SAVE,  PERM  Or  TEMP 

RW  Read/Write  status  (Character,  Input) 

One  of  RO  or  R/w 

USRPRM  Installation  dependent  user  parameters  (Character,  Input) 


I  STAT 


Return  status 

1  Duplicate  database  name 

2  Too  many  databases  open 

3  Bad  RW  parameter 

4  Index  file  block  size  too  small 

5  Bad  data  in  file  found  on  old  open 

6  Password  check  failure  on  old  open 

7  Old  formatted  database  not  supported 

8  Read  only  open  on  new  database  illegal 

9  Bad  STAT  parameter 

100  Values  are  machine  dependent  -  see  DBMDIX 


Method: 

This  routine  opens  the  named  database  for  access.  It  performs  any  machine  and  installation  dependent 
processing  by  accessing  the  database  machine  dependent  library  routines  dbmdcx  and  DBMDIX.  All  the 
in-core  buffers  required  for  subsequent  database  access  are  allocated  using  the  database  memory 
management  routines. 

Design  Requirements: 

1.  The  first  call  to  DBINIT  must  define  the  run-time  or  scratch  database.  Any  other  databases  may 
then  be  initiahzed. 

Error  Conditions: 

1.  Any  error  conditions  on  the  file  operations  occuring  in  DBCINI  will  be  flagged  using  the  ISTAT 
parameter  and  control  returned  to  the  calling  routine. 
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Executive  System  Module:  MAPOL 

Entry  Point:  MAPOL 

PURPOSE: 

Tb  compile  a  MAPOL  program. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MAPOL 

Method: 

The  input  MAPOL  program  or  a  MAPOL  program  representing  a  modified  standard  sequence  is  read 
from  the  &MAPLPKT  imstructured  entity  and  compiled.  The  resultant  machine  code  instructions^d 
memory  map  are  written  to  the  MCODE  and  MEMORY  entities  for  use  by  XQTMON  in  executmg  the  MAPOL 
program. 

Design  Requirements: 

None 

Error  Conditions: 

1.  MAPOL  s}Titax  errors 

2.  Illegal  argument  types  used  in  MAPOL  module  calls 
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Executive  System  Module:  XQTMON 

Entry  Point:  XQTMON 

PURPOSE: 

To  execute  a  set  of  ASTROS  machine  instructions  representing  a  MAPOL  program. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XQTMON 

Method: 

If  no  MAPOL  packet  was  in  the  input  stream,  xqtmon  copies  the  standard  sequence  machine  instruc¬ 
tions  and  memory  map  from  the  system  database  into  the  mcode  and  memory  entities.  If  a  MAPOL 
compilation  took  place,  the  current  sequence’s  data  are  already  in  MCODE  and  MEMORY.  Beginning  with 
the  first  instruction,  which  is  passed  to  XQTMON  from  the  MAPOL  compiler  or  retrieved  from  the  system 
database,  the  machine  instructions  are  executed  by  this  module. 

Most  instructions  are  processed  directly  by  the  XQTMON  module;  for  example,  stack  operations,  entity 
creations  and  scalar  arithmetic  operations.  If  the  instruction  is  a  module  c^l,  however,  the  XQDRIV 
executive  subroutine,  previously  written  by  the  SYSGEN  program,  is  called  to  access  the  MAPOL 
module  to  which  the  machine  instruction  refers. 

Design  Requirements: 

None 

Error  Conditions: 

MAPOL  run  time  errors 
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Executive  System  Module:  xqends 
Entry  Point:  XQENDS 


PURPOSE: 

To  cleanly  terminate  the  ASTROS  execution. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XQENDS 

Method: 

The  executive  module’s  database  entities  that  remain  open  throughout  the  ASTROS  execution  are  closed 
and  the  dbterm  executive  module  is  called  to  close  the  database(s). 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Executive  System  Module: 

Entry  Point:  DBTERM 


DBTERM 


PURPOSE: 

Tb  terminate  processing  of  all  open  database. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBTERM  (  DBNAME  ) 

DBNAME  Database  name  or  blank  (Character,  Input) 

Method: 


The  database  entity  name  table  (ENT)  is  searched  and  all  open  entities  corresponding  to  dbname  are 
closed  and  the  ENT  deleted.  If  dbname  is  blank,  all  open  entities  on  all  databases  are  closed  but  the  ENTs 
are  not  deleted.  If  all  databases  are  to  be  closed,  the  database  name  table  (dbnt)  is  searched  and  all 
in-core  buffers  are  freed.  The  first  record  of  each  database  is  updated  to  indicate  that  it  was  properly 
closed  and  any  system  dependent  termination  is  performed.  If  a  particular  database  is  to  be  closed,  these 
operations  are  done  only  for  the  named  database.  Finally,  if  all  databases  are  closed,  the  ENT,  dbnt  and 
the  name  substitution  table  (NST)  are  released  at  the  close  of  the  DBTERM. 


Design  Requirements: 
None 

Error  Conditions: 


None 
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5.  ENGINEERING  APPLICATION  MODULES 


The  modiiles  documented  in  this  section  fall  under  the  category  of  engineering  apphcation  mod¬ 
ules.  These  modules  constitute  the  majority  of  the  ASTROS  software  and  do  the  tasks  necessary  to 
perform  the  analyses  supported  by  the  ASTROS  system.  Unsurprisingly,  the  difference  between  an 
"engineering  application"  module  and  other  modules  in  the  ASTROS  system  is  not  always  clear.  The  most 
useful  definition  may  be  that  an  engineering  application  module  is  one  that  does  not  fall  into  any  other 
category.  They  do,  however,  share  some  common  attributes  that  can  be  used  to  help  distinguish  them 
from  other  modules.  First,  an  engineering  apphcation  module  has  no  apphcation  calling  sequence;  it  is 
only  accessible  through  the  executive  system.  A  related  attribute  is  that  no  engineering  module  may  be 
called  by  another  module,  whereas  utihty  modules  may  be  called  by  other  modules  or  by  the  executive 
system.  Finally,  an  engineering  apphcation  module  is  one  that  establishes  an  open  core  base  address  by 
railing  the  Mwfw&gp.  and/nr  HMBXSC  utilities  and  uses  that  one  base  address  throughout  its  execution. 

The  following  subsections  docmnent  each  of  the  engineering  apphcation  modules  that  comprise 
the  ASTROS  system.  Each  module  is  documented  using  the  standard  format  shown  in  the  introduction, 
but  some  additional  comments  are  necessary.  First,  the  MAPOL  language  allows  the  use  of  optional 
arguments  in  the  falling  sequences.  This  feature  has  been  used  in  many  modules  to  provide  optional 
print  selections  or  to  aUow  the  module  to  be  used  in  shghtly  different  ways.  This  is  particularly  true  for 
the  matrix  reduction  "modules"  (GREDUCE,  FREDUCE  and  recova)  which  may  almost  be  considered 
utihties.  When  the  argument  in  the  MAPOL  calling  sequence  is  optional,  it  is  so  indicated  in  the  calling 
hst.  The  Method  section  then  describes  the  alternative  operations  that  take  place  depending  on  the 
presence  of  the  optional  argument. 

A  second  point  to  emphsisize  is  the  general  nature  of  the  Method  sections  for  the  engineering  module 
documentation.  In  no  way  does  this  documentation  attempt  to  lead  the  reader  through  the  code  segments  of 
the  module.  Tnstpad,  a  general  descripton  of  the  algorithm  is  given  which,  in  combination  with  the  in-line 
comments,  should  give  the  programmer  an  adequate  understanding  of  the  module.  The  system  programmer 
wanting  to  maVo  extensive  software  modifications  to  existing  modules  will  stiU  need  to  study  the  actual  code 
segments  in  some  detail.  The  level  of  detail  in  the  engineering  module  dociunentation  is  considered  more 
appropriate  for  the  ASTROS  analyst/designer  who  wants  to  imderstand  how  ASTROS  uses  the  existing  pool 
of  engineering  modules  and  to  know  the  "initial  state"  that  the  module  expects  to  exist  when  it  is  called.  The 
analyst  may  then  make  "nonstandard"  use  of  the  module  to  perform  alternative  analyses.  These,  therefore, 
are  the  data  emphasized  in  the  module  documentation  that  follows. 

A  final  note  should  be  made  relative  to  the  description  of  the  MAPOL  module  calling  sequences. 
Version  12  of  ASTROS  has  introduced  user  defined  boundary  condition  identification  numbers,  called 
BCID  in  this  chapter,  which  are  used  when  specifying  user  defined  functions.  These  are  not  to  be  confused 
with  the  boimdary  condition  index,  or  subscript,  which  is  a  sequential  coimter  used  in  MAPOL.  This 
coxmter  is  shown  as  the  entity  subscript  BC. 
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Engineering  Application  Module :  ABOUND 


Entry  Point:  ABOUND 


Purpose: 

Tb  generate  flags  for  the  current  boundary  condition  that  indicate  which  constraint  types  are  active. 
These  are  then  returned  to  the  executive  sequence  to  direct  the  execution  of  the  required  sensitivity 
analyses. 

MAPOL  Calling  Sequence: 

CALL  ABOUND  {  NITER,  BCID,  CONST,  NDV,  ACTBOUND,  NAUS,  NACSD,  [PGAS]  ,  PCAS, 
PRAS,  ACTAERO,  ACTDYN,  ACTFLUT,  ACTPNL,  ACTBAR,  NMPC, 

NSPC,  NOMIT,  NRSET,  NGDR,  USET(BC)  ); 


NITER 

BCID 

CONST 

NDV 

ACTBOUND 

NAUS 

NACSD 

[PGAS] 

PCAS 


PRAS 

ACTAERO 

ACTDYN 

ACTFLUT 

ACTPNL 

ACTBAR 

NMPC 

NSPC 

NOMIT 


Design  iteration  number  (Integer,  Input) 

User  defined  boundary  condition  identification  number  (Integer,  Input) 
Relation  of  constraint  values  (Character,  Input) 

Number  of  design  variables  (Integer, Input) 

Logical  flag,  TRUE  if  boundary  condition  is  active  (Logical, Output) 

Number  of  active  STATICS  displacement  vectors  (Integer,  Output) 

Number  of  active  STATICS  stress  and/or  displacement  constraints. 
(Integer,  Output) 

Partition  vector  for  active  STATICS  displacement  vectors  (Output) 

Unstructured  entity  which  contains  the  unique  STATICS  subcase  num¬ 
bers  for  the  displacement  dependent  STATKDS  constraints  that  are  active 
for  the  boundary  condition.  Only  constraints  for  the  current  boundary  con¬ 
dition  are  included  in  the  fist  (Output) 

Unstructured  entity  which  contains  the  unique  STATICS  subcase  num¬ 
bers  for  the  response  functions  that  are  required  by  active  user  function 
constraints  (Output) 

Logical  flag,  TRUE  if  any  active  aeroelastic  effectiveness  constraints 
and/or  responses-(Logical, Output) 

Logical  flag,  true  if  any  active  firequency  constraints  and/or  responses 
(LogicaljOutput) 

Logical  flag,  TRUE  if  any  active  flutter  constraints  and/or  responses  (Logi- 
cal,Output) 

Logical  flag,  TRUE  if  any  active  panel  buckling  constraints 
(Logical, Output) 

Logical  flag,  true  if  any  active  Euler  buckling  constraints 
(Logical, Output) 

Number  of  MPC  degrees  of  freedom  (Integer,  Output) 

Number  of  SPC  degrees  of  freedom  (Integer,  Output) 

Number  of  omitted  DOF  (Integer,  Output) 
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NRSET 


NGDR 


USET(BC) 


Number  of  support  DOF  (Integer,  Output) 

Denotes  dynamic  reduction  in  the  boundary  condition  (Integer,  Output) 

=  0  No  GDR 
s  -1  GDR  is  used 

The  imstructured  entity  defining  structural  sets  for  each  degree  of  free¬ 
dom  (Character,  Input),  where  BC  represents  the  MAPOL  boimdary  condi¬ 
tion  loop  index  number. 


Apphcation  Calling  Sequence: 
None 


Method: 

The  module  first  reads  the  CONST  relation  for  active  constraints  associated  with  the  botmdary  condition. 
If  any  entries  are  found,  the  actboond  flag  is  set  to  on.  If  not,  control  is  returned  to  the  executive. 

The  CASE  relation  is  then  read  for  all  subcases  associated  with  the  boundary  condition.  The  number  of 
STATICS  subcases  is  counted  in  preparation  for  determining  the  partitioning  vector  of  active  subcases 
and  fhe  counts  of  right-hand-sides  and  constraints  that  will  determine  if  the  ^adient  or  virtual  load 
method  will  be  used  in  sensitivity  analysis.  SAERO  disciplines  cannot  use  the  virtual  load  method  and 
are  therefore  not  treated  in  this  manner. 

Then  the  USET  and  CASE  entities  are  searched  to  set  the  boundary  condition  flags  that  are  output  to 
control  the  reduction  processes  during  the  sensitivity  phase.  Then  the  work  of  the  module  begins. 

The  active  subcases  and  constraint  types  are  determined  for  each  of  the  entries  in  const  that  were 
read.  During  the  pass  through  the  active  constraint  set,  the  partitiomng  vector  for  the  STATlOb 
displacement  matrix  is  built  (of  the  number  of  right-hand-sides  columns,  only  the  NADS  columns  wiU  be 
active).  For  STATICS  constraints  that  are  dependent  on  the  displacement  vector  derivatives,  the  active 
subcase  is  identified  and  the  partitioning  vector,  PGAS,  and  the  set  of  subcase  ids  that  are  active, 
are  loaded.  Any  subcases  which  have  displacement  or  element  stress/strain  response  functions  required 
because  there  are  active  user  functional  constraints,  are  also  defined  as  active.  The  partitioning  vector, 
PGAS,  the  set  of  subcase  numbers  that  are  active,  PRAS,  are  loaded. 

Then  a  summary  of  all  the  active  constraints  for  the  boundary  condition  is  echoed  to  the  output  file. 
Design  Requirements: 

1.  This  module  must  follow  the  complete  analysis  phase  for  all  the  boundary  conditions  and  is  the  first 
module  called  within  the  sensitivity  boundary  condition  loop. 

Error  Conditions: 

None 
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Engineering  Application  Module:  ACTCON 


Entry  Point:  ACTCON 


Purpose: 

lb  determine  whether  the  design  task  has  converged.  If  the  optimization  has  not  converged,  this  module 
selects  which  constraints  are  to  be  included  in  the  current  redesign.  On  print  request,  this  routine 
computes  and  prints  the  values  of  the  local  design  variables. 

MAPOL  Calling  Sequence: 

CALL  ACTCON  (  NITER,  MAXITER,  NRFAC,  NDV,  GLBDES,  LOCLVAR,  [PTRANS] ,  EPS, 
APPCNVRG,  GLBCNVRG,  CTL,  CTLMIN,  CONST,  [AMAT] ,  DESHIST, 

PFLAG,  OLOCALDV  ); 


NITER 

MAXITER 

NRFAC 

NDV 

GLBDES 

LOCLVAR 

[PTRANS] 

EPS 

APPCNVRG 


GLBCNVRG 

CTL 

CTLMIN 

CONST 

[AMAT] 

DESHIST 

PFLAG 

OLOCALDV 


The  current  iteration  number  (Integer,  Input) 

The  maximum  number  of  allowable  iterations  (Integer,  Input) 

Determines  the  minimum  number  of  retained  constraints  equal  to 
NRFAC*NDV  (Real,  Input) 

The  number  of  global  design  variables  (Integer,  Input) 

Relation  of  global  design  variables  (Character,  Input) 

Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Character,  Input) 

The  design  variable  linking  matrix  (Character,  Input) 

A  second  criteria  for  constraint  retention.  All  constraints  greater  than  or 
equal  to  EPS  will  be  retained  (Real,  Input) 

The  approximate  problem  converge  flag  from  module  DESIGN  or  FSD 
(Logical,  Input) 

=  FALSE  if  not  converged 

=  TRUE  if  no  change  in  objective  function  value  and  design  variables 

Final  convergence  flag  (Logical,  Output) 

=  FALSE  if  not  converged 
=  TRUE  if  global  converge  was  achieved 

Constraint  tolerance  for  active  constraints  (Real,  Input) 

Constraint  tolerance  for  violated  constraints  (Real,  Input) 

Relation  of  constraint  values  (Character,  Input) 

The  matrix  entity  of  constraint  gradients  (Output) 

Relation  of  design  iteration  information  (Character,  Input) 

The  logical  flag  to  indicate  if  design  model  pimching  is  requested  for  the 
current  iteration  (Logical,  Input) 

Relation  to  store  the  output  local  design  variables  requested  in  solution 
control  (Character,  Input) 
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Application  Calling  Sequence: 


None 

Method: 

The  initial  action  of  the  ACTCON  module  is  to  flush  the  [amat]  matrix  of  constraint  gradients  for  the 
sensitivity  analysis  that  is  to  follow.  This  erases  the  constraint  sensitivities  from  the  previous  design 
iteration  and  prepares  the  matrix  to  be  loaded  by  the  constraint  sensitivity  evaluation  modules. 
Following  this  bookkeeping  task,  the  ACTCON  module  begins  the  process  of  selectmg  the  active 
constraints  for  the  next  redesign  cycle.  The  first  computation  of  the  number  of  retamed  constramts  is 
done  using  the  value  nrfac*ndv.  This  represents  a  minimum  number  of  constraints  to  retam.  Ihe 
vector  of  current  constraint  values  is  brought  into  core  and  sorted.  Then  the  EPS  value  and  initial  number 
of  retained  constraints  are  used  to  determine  the  cutoff  value  for  the  active  constramts.  This  cutoff 
value,  CMIN,  will  either  be  the  constraint  value  such  that  NRFAC*NDV  constraints  are  retamed,  the 
constraint  v^ue  closest  to,  but  less  than,  eps  or  the  minimum  constraint  v^ue  if  there  are  fewer  than 
NRFAC*NDV  constraints.  During  this  phase  the  count  of  thickness  constraints  that  are  retamed  even 
though  they  do  not  satisfy  the  nrfac  and  EPS  retension  criteria  is  kept.  A  summary  is  printed  that 
indicates  the  number  of  constraints  kept  for  each  reason:  NRFAC,  EPS  and  DCONTHK. 

If  the  approximate  problem  convergence  flag,  APPCNimo,  is  TRUE,  the  maximum  constraint  value  is 
tested  to  determine  if  global  convergence  has  been  achieved  based  on  ctl  and  ctlmin.  The  glbcnvrg 
flag  is  set  to  TRUE  if  global  convergence  has  been  reached. 

The  next  task  of  the  ACTCON  module  is  to  set  the  active  constraint  attribute  in  the  CONST  relation.  T^s 
is  done  by  retrieving  each  tuple  of  the  CONST  relation  and  comparing  the  constraint  value  against  the 
cutoff  value,  CMIN.  The  appropriate  constraints  are  then  marked  active  by  setting  the  actvflag 
attribute  to  unity.  Finally,  the  ACTCON  module  prints  out  the  results  of  the  design  process  if  global 
convergence  or  the  maximum  number  of  iterations  has  been  reached.  This  includes  the  print  of  the 
design  iteration  history  and,  if  requested  by  Solution  Control,  the  summary  of  global  and  local  design 
variables. 

Design  Requirements: 

1  ACTCON  must  be  the  first  module  called  follovsing  the  analysis  phase  of  the  optimization  segment  of 
the  standard  sequence.  That  is,  it  follows  all  the  analysis  boundary  conditions  but  precedes  the 
sensitivity  evaluations. 

Error  Conditions: 

1.  No  design  constraints  have  been  applied  in  the  optimization  problem. 
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Engineering  Application  Module;  AEROEFFS 


Entry  Point:  AROSEF 
Purpose: 

Evaluates  aeroelastic  effectiveness  sensitivities. 


MAPOL  Calling  Sequence: 

CALIi  AEROEFFS  (  NITER,  BCID,  SX7B,  SYM,  NDV,  CONST,  PCAE,  [EFFSENS]  ,  [AMAT]  )  ; 


NITER 

BCID 

SUB 

SYM 

NDV 

CONST 

PCAE 

EFFSENS 

AMAT 


Current  iteration  number  (Input,  Integer) 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

Current  static  aeroelastic  subscript  number  (Input,  Integer) 

Symmetry  flag  for  the  cxirrent  call.  Either  1  for  symmetric  or  -1  for  anti¬ 
symmetric  (Input,  Integer) 

Number  of  global  design  variables  (Input, Integer) 

Relation  of  design  constraints  (Input) 

Unstructured  entity  containing  information  indicating  which  pseudodis¬ 
placements  (displacements  due  to  unit  configuration  parameters)  are  ac¬ 
tive  for  the  current  design  iteration  (Input) 

The  matrix  of  dimensional  stabihty  derivative  sensitivities  (Input) 

The  matrix  of  constraint  gradients  (Output) 


Method: 

The  CASE  relation  is  read  first  to  retrieve  the  SUPPORT  set  for  the  current  boundary  condition.  The 
number  and  location  of  the  support  DOF  are  returned  from  the  utility  routine  SEFCHK.  Then  the  CONST 
relation  is  read  for  active  lift  effectiveness  (dconcla),  aileron  effectiveness  (dconale)  and  stability 
coefficient  constraints  (DCONSCF)  for  the  current  boundary  condition,  subscript  and  iteration. 

The  EFFSENS  matrix,  of  dimension  NSUP*ndv*naue  where  NSUP  is  the  number  of  support  dofs  and 
NAUE  is  the  number  of  active  pseudodisplacement  fields  of  the  set  computed  in  SAERO  for  the  applied 
constraints. 


The  whole  EFFSENS  matrix  is  read  into  memory  and  then  the  loop  over  active  constrEiints  begins.  For 
each  active  constraint,  the  DISPCOL  attribute  of  the  CONST  relation  is  used  to  determine  which  column 
of  pseudodisplacements  is  associated  with  the  constraint.  The  PCAE  entity  is  then  used  to  determine 
which  column  of  the  reduced  set  of  active  pseudodisplacement  fields  is  the  proper  column.  Once  located, 
the  constraint  sensitivities  may  be  computed  from  the  dimensional  stability  coefficient  derivatives  and 
the  normalization  data  stored  in  the  CONST  relation  in  the  SAERO  module.  The  constraint  derivatives 
are  computed  from  the  following  relationships. 

The  flexible  stabihty  coefficient  response  sensitivities  which  are  required  by  the  active  user  function 
constraints  are  also  computed  in  this  module.  Those  sensitivities  are  stored  into  relational  and  matrix 
entities  to  be  used  by  the  user  function  evaluation  utflities. 
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Lift  Effectiveness: 
Upper  Bound 


CLAREQ  >0.0 

DG/DX  =  SENS  ROW  /  (CLA  *  CLAREQ  ) 

RIGID 

CLAREQ  <0.0 

DG/DX  =  -SENS  ROW  /  (CLA  *  CLAREQ  ) 

RIGID 

CLAREQ  =  0.0 

DG/DX  =  SENS  ROW  /  CLA 

RIGID  _ 


Lower  Boimd 


where  CLArigid  is  stored  in  the  SENSPRMl  attribute  of  CONST  and  CLAREQ  is  stored  m  the  SENSPRM2 
attribute  of  CONST 

Aileron  Effectiveness: 

Upper  Bound  _ _ 

AEREQ  >0.0 

DG/DX  =(-SENS  *  CMXP  +  SENS  *  CMXA  )  /  (AEREQ  *  CMXP  2 

1  FLX  2  FLX  FLX 

AEREQ  <0.0 

DG/DX  =(  SENS  *  CMXP  -  SENS  *  CMXA  )  /  (AEREQ  *  CMXP  **2 
1  FLX  2  FLX  FLX 

AEREQ  =0.0 

DG/DX  =(-SENS  *  CMXP  +  SENS  *  CMXA  )  /  CMXP  **  2 

1  FLX  2 _ FLX  FLX _ _ 


Lower  Bound 


AEREQ  >0.0 

DG/DX  =(  SENS  *  CMXP  -  SENS  *  CMXA  )  /  (AEREQ  *  CMXP  **2 
1  FLX  2  FLX  FLX 

AEREQ  <0.0 

DG/DX  =(-SENS  *  CMXP  +  SENS  *  CMXA  )  /  (AEREQ  *  CMXP  **2 
1  FLX  2  FLX  FLX 

AEREQ  =0.0 

DG/DX  =(  SENS  *  CMXP  -  SENS  *  CMXA  )  /  CMXP  **  2 

FLX  2  FLX  FLX 
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where  CXMAflex  is  stored  in  the  SENSPRMl  attribute  of  CONST  and  CMXPflex  is  stored  in  the 
SENSPBM2  attribute  of  CONST  and  2 . 0*AEREQ/  (57 . 3*REFB)  is  in  SENSPBM3 

Stabihty  Coefficient: 

Upper  Bound 


REQ  >0.0 

DG/DX  = 

SENS  ROW  /  REQ 

REQ  <0.0 

DG/DX  = 

-SENS  ROW  /  REQ 

REQ  =0.0 

DG/DX  = 

SENS  ROW 

Lower  Bound 


REQ  >0.0 

DG/DX  = 

-SENS  ROW  /  REQ 

REQ  <0.0 

DG/DX  = 

SENS  ROW  /  REQ 

REQ  =0.0 

DG/DX  = 

-SENS  ROW 

where  REQ,  the  dimensional  required  value  is  stored  in  the  SENSPRMl  attribute  of  CONST 

The  rows  of  effsens  associated  with  each  constraint  are  dependent  on  the  constraint  type  in  the 
following  way: 

(1)  Lift  Effectiveness  constraints  always  use  the  plunge  DOF 

(2)  Aileron  Effectiveness  constraints  always  use  the  roll  DOF 

(3)  Stability  Coefficient  constraints  always  use  the  row  associated  with  the  constrained  axis.  The 
constrained  axis  number  (1,2, 3, 4, 5, 6)  is  stored  in  real  form  in  the  SENSPRM2  attribute  of  CONST. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  aeroSENS 

Entry  Point:  AROSNS 

Purpose: 

lb  compute  the  sensitivities  of  the  rigid  body  accelerations  and  aerodynamic  performance  parameters 
(DCONTRM)  for  active  steady  aeroelastic  subcases  associated  with  the  current  subscript. 

MAPOL  Calling  Sequence: 

r^T.T.  AEROSENS  (  NITER,  BCID,  MINDEX,  SUB,  CONST,  SYM,  NDV,  BGPDT(BC),  STABCF, 
[PGAA],  [LHSA(BC,SUB)],  [RHSA{BC, SUB) ] ,  [DRHS] ,  [AAR], 

[DDELDV] ,  [AMAT]  ) ; 


NITER 

Design  iteration  number  (Integer,  Input) 

BCID 

User  defined  boimdary  condition  identification  number  (Integer,  Input) 

MINDEX 

Mach  number  index  for  the  boundary  condition  to  recover  the  proper  sta- 
bihty  coefficient  data  (Integer,  Input) 

SUB 

The  subscript  identifier  for  the  current  saero  subcases  (Integer,  Input) 

CONST 

Relation  of  constraint  values  (Character,  Input) 

NDV 

The  number  of  global  design  variables  (Integer,  Input) 

SYM 

The  symmetry  flag  for  the  current  SAERO  subcases  (Integer,  Input) 

B6PDT(BC) 

Relation  of  basic  grid  point  coordinate  data  (Character,  Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number 

STABCF 

Relation  of  rigid  stability  coefficient  data  (Character,  Input) 

[PGAA] 

Partitioning  vector  used  to  obtain  g-set  active  displacement  and  accelera¬ 
tion  vectors  for  all  static  aero  subcases  that  have  active  trim  parameter, 
stress,  strain  and/or  displacement  constraints.  (Input) 

[LHSA(BC,SUB) ] 

Modified  inertia  matrix  (Character,  Input),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  number 

[RHSA(BC,SUB)] 

Modified  applied  load  matrix  (Character,  Input),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  number 

[DRES] 

Matrix  entity  containing  the  sensitivity  of  [RHSA]  to  the  design  variables 
(Character,  Input) 

[AAR] 

Matrix  entity  containing  the  sensitivities  of  structural  accelerations 
either  zero  (for  fixed  accelerations)  or  from  solution  of 

LHSA*AAR  =  RHSA*DDELDV  +  DRHS  (Output) 

[DDELDV] 

Matrix  entity  containing  the  sensitivity  of  the  configuration  parameters 
to  the  design  variables.  Either  zero  (for  FIXED  control  parameters)  or 
from  the  solution  of 

LHSA*AAR  =  RHSA*DDELDV  +  DRHS  (Output) 

[AMAT] 

Matrix  entity  containing  the  sensitivities  of  the  active  aeroelastic  control  pa¬ 
rameter  (DCONTRM)  constraints  to  the  design  variables  (Character,  Output) 
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Application  Calling  Sequence: 

None 

Method: 

First  the  CASE  relation  is  read  for  the  saero  subcases  in  the  boundary  condition.  Then  the  STABCF 
entity  is  read  for  the  terms  associated  with  the  current  mindex.  Then  the  trim,  control  linking  and 
control  effectiveness  data  are  read.  Finally,  the  CONST  relation  for  the  active  DCONTRM,  stress  and 
displacement  constraints  associated  with  the  current  subscript  value  are  read  into  memory.  Then  the 
number  of  trim  subcases  (active/associated  with  SUB)  is  determined  and  the  PGAA  matrix  is  read  and 
the  number  of  active  subcases  is  determined.  The  number  of  columns  in  the  drhs  matrix  (=NDV*number 
of  active  subcases  for  this  SUB  value)  is  determined. 

At  this  point,  an  trim  solution  very  similar  to  the  one  done  in  the  saero  analysis  module  is  performed 
to  solve  for  the  AAR  rigid  body  acceleration  derivatives  and  the  DDELDV  trim  parameter  sensitivities. 
The  DRHS  matrix  is  difficult  to  deal  with  since  it  must  be  partitioned  for  each  subcase  to  just  the  NDV 
columns  associated  with  the  subcase  under  consideration.  (Just  as  in  saero,  each  subcase  must  be 
solved  for  independently  since  the  effectiveness  and  control  linking  are  subcase  dependent.)  Given  the 
correct  NDV  columns  in  DRHS,  the  following  matrix  expression  is  available: 


-LHS,^  LHS^^- 

■^froe' 

LHS,^^  LHS,^ 

RHS,„  RHS^^ 
RHS,^^ 


DEL„ 

del, 

s 


DRHS^ 

DRHSj^ 


Where: 

Represents: 

F+K 

Number  of  SUPORT  point  DOF 

F 

Set  of  free  accelerations,  ar 

K 

Set  of  known(FlXED)  accelerations,  AR 

U+S 

Number  of  aero  parameters 

u 

Set  of  unknown  parameters 

s 

Set  of  set(FiXED)  parameters 

Note  that  ARknown  and  DELs  sensitivities  are  zero  by  defini-  1 
tion.  1 

These  equations  must  be  rearranged  to  get  free  accelerations  and  unknown  delta’s  on  the  same  side  of 
the  equation: 


■  LHS^,  -RHS,„  ■ 

■  ^free  ' 

■  -LHS^^ 

■ 

_1_ 

■  DRHSf 

LHS,^,  -RHS^ 

del^ 

DEL^ 

DRHSj^ 

We  must  handle  the  degenerate  case  where  all  accelerations  or  all  delta’s  are  known.  Once  the  solution 
is  obtained,  the  free  acceleration  derivatives  and  unknown  trim  parameter  derivatives  are  unscrambled 
and  loaded  into  subcase  specific  AAR  and  DDELDV  entities. 
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Finally,  if  any  active  dcontrm  constraints  exist,  the  AAR  or  ddeldv  matrix  for  the  current  subcase  is 
used  to  compute  the  amat  terms  for  them. 

Upper  bound 


REQ  >0.0 

DG/DX  = 

SENS  / 

REQ 

REQ  <0.0 

DG/DX  = 

-  SENS 

/  REQ 

REQ  =0.0 

DG/DX  = 

SENS 

Lower  bound 


REQ  >0.0 

DG/DX  = 

-  SENS 

/  REQ 

REQ  <0.0 

DG/DX  = 

SENS  / 

REQ 

REQ  =0.0 

DG/DX  = 

-  SENS 

Where  REQ  is  stored  in  the  SENSPRMl  attribute  of  CONST  and  SENS  is  the  raw  acceleration  or  deflection 
sensitivity. 

The  final  operation  for  the  subcase  is  to  merge  the  NDV  AAR  and  DDELDV  columns  for  the  current  subcase 
into  the  output  matrices.  The  output  matrices  have  NDV  columns  for  each  active  subcase  in  subcase 
order  of  SAERO  disciplines  in  the  case  relation. 

The  trim  parameter  response  sensitivities  which  are  required  by  the  active  user  function  constraints 
are  also  computed  in  this  module. 

Design  Requirements: 

1.  This  module  assumes  that  either  strength  and/or  DCONTRM  constraints  exist  for  the  static  aeroelastic 
analyses  in  the  current  boundary  condition. 

Error  Conditions: 


None 


Engineering  Application  Module:  AMP 
Entry  Point:  AMP 


[AJJTL]  , 


Purpose: 

lb  compute  the  discipline  dependent  unsteady  aerodynamic  matrices  for  flutter,  gust  and  blast  analyses. 
MAPOL  Calling  Sequence: 

[DIJK],  [D2JK],  [SKJ],  IQKKL],  [QKJL] ,  [QJJL] ,  [AJJDC]  ); 

Matrix  containing  the  list  of  AIC  matrices  for  each  Mach  nTimber,  reduced 
frequency  and  symmetry  option  in  transposed  form  (Input) 

Real  part  of  the  substantial  derivative  matrix  (Input) 

Imaginary  part  of  the  substantial  derivative  matrix  (Input) 

Integration  matrix  (Input) 

Matrix  list  containing  the  matrix  product: 

[SKJ]* [TRANS (AJJT)]“^*(  [DIJK]  +  ik[D2JK]) 
used  for  flutter  and  gust  analyses  (Output) 

Matrix  list  containing  the  matrix  product; 

[ SKJ]  *  [ TRANS ( A JJT ) ]  ' 

used  for  gust  analyses  (Output) 


CALL  AMP  ( 
[AJJTL] 

[DIJK] 

[D2JK] 

[SKJ] 

[QKKL] 

[QKJL] 


[QJJL] 


[AJJDC] 


Matrix  list  containing  the  matrix  product: 

[TRANS (AJJT) ] “^ 

used  for  nuclear  blast  analyses  (Output) 

Optional  scratch  entity  to  store  the  intermediate  matrix  product: 

[TRANS  (AJJT)]"^  *  (  [DIJK]  +  ik[D2JK]) 
from  the  QKK  matrix  calculation  (Output) 


Application  Calling  Sequence: 
None 


Method: 

The  AMP  module  begins  by  querying  the  CASE  relation  and  determining  if  any  GUST,  BLAST  and/or 
plotter  cases  exist.  If  any  of  these  disciplines  or  options  are  selected,  the  amp  module  proceeds  to 
compute  the  reqmsite  matrix  lists.  The  PLOTTER  bulk  data  and  the  tJNMK  data  are  prepared  in  core 
the  PREFL  and  PRDNMK  utilities.  As  a  separate  step,  the  second  record  of  the  PNMK  is  queried  to  determine 
the  number  of  aerodynamic  interference  groups  in  the  model  so  that  the  structure  of  the  aerodynamic 
matrices  can  be  interpreted  correctly.  As  a  final  initialization  task,  the  existence  of  both  subsonic  and 
supersonic  matrices  is  checked  since  the  DIJK  and  D2JK  matrices  are  different  for  subsonic  and 
supersonic  aerodynamics  due  to  the  different  control  point  used. 

The  module  then  begins  to  loop  through  the  set  of  m-k  pairs  in  the  DNMK  entity.  For  each  new  Mach 
number/symmetry  group  (denoted  by  the  SGRP  flag),  the  DNMK  and  case  relation  data  formed  in  prunmk 
is  checked  to  determine  which  of  the  three  discipline  dependent  matrix  fists  are  to  be  formed  for  the 
reduced  frequencies  associated  with  the  Mach  number  and  symmetry  group.  If  PLOTTER  or  GUST 


disciplines  are  associated  with  the  Mach/SGRP  set,  the  corresponding  NJ  columns  of  SKJ  are  extracted 
from  the  SKJ  list  input  in  the  calling  sequence.  Also,  the  NJ  columns  of  ajjtl  are  extracted  irrespective 
of  the  discipline  options.  Finally,  if  the  QKK  matrix  is  to  be  formed,  the  DIJK  and  p2JK  are  processed 
depending  on  the  presence  of  both  subsonic  and  supersonic  forms.  This  processing  consists  of  the 
extraction  of  the  second  NK  columns  of  DIJK  andD2  JK  on  the  first  supersonic  Mach  number  encountered. 
The  appropriate  matrices  are  then  added  together  for  the  ciurent  reduced  frequency  as: 

[DCJK]  =  [DIJK]  +  (0+ik) [D2JK] 

At  this  point,  the  module  is  ready  to  deal  with  the  AJJT  matrix  previously  extracted.  The  processing  of 
this  matrix  depends  on  the  presence  of  different  interference  groups  in  the  unsteady  aerodynamics 
model.  For  the  case  with  a  single  interference  group,  the  extracted  AJJT  matrix  is  transposed  and  then 
decomposed.  If  the  QKK  matrix  is  required,  the  following  matrix  is  formed  using  the  GFBS  utility: 

[SCRDC]  =  [AJJ]  [DCOK] 

If  either  the  QJJ  or  QJK  matrices  are  needed,  the  actual  inverse  of  ajj  is  formed  and  stored  as  QJJ.  If 
the  QJK  matrix  is  needed  as  well,  the  QJJ  matrix  is  used  to  form  the  QJK  matrix  as: 

[QJK]  =  [SKJ] [QJJ] 

If  there  is  more  than  one  interference  group,  the  alternate  path  is  used  to  obtain  the  SCRDC,  QJJ  and/or 
QJK  matrices.  In  this  path,  a  loop  is  performed  for  each  interference  group.  The  second  record  of  the 
UNMK  entity  is  used  to  determine  the  number  of  j-set  and  k-set  degrees  of  freedom  in  the  current 
interference  group.  These  are  used  to  generate  the  prtj  partitioning  vector  for  the  AJJ  matrix.  This 
vector  acts  as  a  floating  NJG-sized  vector  to  extract  the  N  JG  columns  and  rows  associated  with  the  current 
group.  The  AJJT  matrix  is  then  partitioned,  transposed  and  decomposed  to  form  A  J  JG.  If  the  QKK  matrix 
is  needed,  the  PRTK  partitioning  vector  is  also  required.  This  vector  is  a  floating  NKG-sized  vector  to 
extract  the  nkg  columns  or  rows  for  the  current  interference  group.  The  DCJK  matrix  is  then  partitioned 
for  the  current  group  and  used  as  follows: 

[AJJDCG]  =  [AJJG]  [DCJKG] 

The  INMAT  utility  is  then  used  to  merge  this  matrix  into  the  scrdc  matrix  using  the  interference  group 
partitioning  information.  As  before,  if  the  QJJ  or  QJK  matrices  are  needed,  the  AJJG  matrix  is  inverted 
anri  stored  as  QJJG.  The  inmat  utility  merges  this  matrix  into  the  QJJ  matrix.  At  the  conclusion  of  the 
interference  group  loop,  the  SCRDC  and  QJJ  matrices  are  complete.  At  this  point,  the  logic  recombines 
for  both  paths.  If  the  QKK  matrix  is  needed,  the  sCRDC  matrix  is  used  to  compute  QKK  as: 

[QKK]  =  [SKJ] [SCRDC] 

which  is  then  appended  onto  the  hst  of  QKK  matrices,  qkkl.  If  the  QJK  matrix  is  needed,  the  QJJ  matrix 
is  used  to  comput  QJK  as: 

[QJK]  =  [SKJ] [QJJ] 

which  is  then  appended  onto  the  hst  of  QJK  matrices,  QJKL.  Finally,  the  computed  QJJ  matrix  is 
appended  to  the  Q  JJL  matrix  hst  if  it  is  required  for  this  m-k/SGRP  matrix.  The  module  then  continues 
with  the  next  m-k/SGRP  matrix  in  the  XJNMK  entity.  Note  that  all  the  matrix  hsts  are  formed  in  the  order 
the  m-k/SGRP  data  appear  in  the  UNMK,  although  each  hst  need  not  have  all  sets.  Once  the  entire  set  of 
mk/SGRP  sets  in  the  UNMK  have  been  processed,  the  module  terminates  by  destroying  the  niunerous 
scratch  matrices  used  in  the  computations. 
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Design  Requirements: 


1.  The  FLUTTER  bulk  data  entries  and  the  CASE  relation  are  used  to  determine  the  set  of  m-k/symmetry 
pairs  for  each  aerodynamic  matrices  required  for  each  discipline.  The  data  on  the  database  will  be  used 
to  determine  the  set  of  matrices  to  be  computed. 

Error  Conditions: 

None 
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Engineering  Application  Module:  2VNALINIT 

Entry  Point:  ANINIT 

Purpose: 

Initializes  the  final  analysis  pass.  This  module  should  be  called  at  the  beginning  of  the  final  analysis 
loop  to  set  parameters  as  needed  for  that  pass. 

MAPOL  Calling  Sequence: 

CAIiL  A1I2U<INIT; 

Application  Calling  Sequence: 

None 

Method: 

This  module  is  called  to  perform  any  actions  needed  to  transition  firom  the  optimization  segment  of 
ASTROS  to  the  analysis  segment.  Currently,  the  only  action  taken  by  the  module  is  to  overwrite  the 
portion  of  the  SUBTITLE  that  is  used  to  denote  the  design  iteration  number  (set  in  iterinit)  with  the 
label "FINAL  ANALYSIS  SEGMENT." 

Design  Requirements: 

1.  This  routine  overwrites  the  characters  88-128  of  the  subtit  variable  in  /  outpt2  /  used  by  utpage. 
No  other  application  modules  except  OPP  should  modify  the  title,  subtit,  label  variables  beyond 
the  72nd  character,  since  these  fields  are  used  to  set  dates,  page  numbers  and  subcase  information. 

Error  Conditions: 

None 
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Engineering  Application  Module:  APFLUSH 

Entry  Point:  APFLUSH 


Purpose: 

Flushs  user  function  related  intrinsic  response  and  response  gradient  entities  which  are  design  iteration 
dependent.  This  module  should  be  called  at  the  begioning  of  each  design  iteration. 

MAPOL  Calling  Sequence: 

CALL  APFLUSH; 

Application  Calling  Sequence: 

None 

Method: 

This  module  must  be  called  at  the  top  of  each  design  iteration  loop.  It  checks  the  existence  of  aU  design 
iteration  dependent  relational  and  matrix  entities  containmg  response  functions  and  their  gradients, 
and  flushes  any  that  exist. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module: 

Entry  Point:  AROSDR 


AROSNSDR 


Purpose: 

MAPOL  director  for  saero  sensitivity  analyses 
MAPOL  Calling  Sequence: 

rar.T.  AROSNSDR  {  NITER,  BCID,  SUB,  NDV,  LOOP,  MINDEX,  CONST,  SYM,  NGDR, 

IPGDRG(BC)],  [UAG(BC)],  [AA.G{BC)],  ACTUAG,  [UGA] ,  [AGA]  ,  , 
[PGAA] ,  [PGAU] ,  PCAA,  PRAA,  [UAGC (BC, SUB) ] ,  [AAGC (BC, SUB) ] , 
ACTAEFF,  [AUAGC],  [AAAGC] ,  PCAE  ); 


NITER  Current  iteration  number  (Input,  Integer) 

bcid  User  defined  boimdary  condition  identification  number  (Integer,  Input) 

SOT  Current  static  aeroelastic  subscript  number  (Input,  Integer) 


NDV  Number  of  deisgn  variables  (Input,  Integer) 

LOOP  A  logical  flag  set  to  indicate  whether  additional  MINDEX  subscripts  are 

needed  to  complete  the  processing  of  all  the  active  Mach  number/Symme- 
try  conditions  on  all  the  TRIM  entries.  One  pass  for  each  unique  active 
Mach  number  will  be  performed  with  mindex  set  as  appropriate  for  the 
active  pass  until  this  routine  returns  LOOP=PALSE  (Logical,  Output) 

MINDEX  Mach  number  index  value  of  the  current  pass  (Output,  Integer) 


CONST 

SYM 

NGDR 


[PGDRG(BC)] 


[UAG(BC) ] 

[AAGCBC)] 


ACTUAG 


Relation  of  design  constraints  (Input) 

Symmetry  flag  for  the  current  pass.  Either  1  for  symmetric  or  -1  for  anti¬ 
symmetric  (Output,  Integer) 

Denotes  dynamic  reduction  in  the  boimdary  condition  (Input,  Integer) 

=  0  No  GDR 
=  -1  GDR  is  used 

A  partitioning  vector  that  removes  the  additional  GDR  scalar  points  from 
the  g-set  sized  displacement  and  acceleration  vectors.  Required  only  if 
NGDR  ^  0  (Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

g-set  displacement  vector  for  all  static  aero  subcases  in  the  current  boimd- 
ary  condition  (Input),  where  BC  represents  the  MAPOL  boundary  condi¬ 
tion  loop  index  number 

g-set  acceleration  vector  for  all  static  aero  subcases  in  the  current  bound¬ 
ary  condition  (Input),  where  BC  represents  the  MAPOL  boundary  condi¬ 
tion  loop  index  number 

Logical  flag  that  is  set  to  TRUE  if  there  are  any  active  constraints  that  re¬ 
quire  the  displacements  or  accelerations.  Those  constraints  are  trim  pa¬ 
rameters,  stresses,  strains  and  displacements  (Output,  Logical) 
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[UGA.] 

[AGA] 

[FGAA] 

[PGAU] 

PCAA 

PRAA 

[UA6C (BC, SUB) ] 

[AAGC (BC, SUB) ] 

ACTAEFP 

[AUAGC] 

[AAAGC] 

PCAE 


Reduced  g-set  active  displacement  vectors  for  all  static  aero  subcases  that 
have  active  trim  parameter,  stress,  strain  and/or  displacement  con¬ 
straints.  This  is  a  subset  of  the  colmnns  of  [uag(bc)  ]  and  does  not  in¬ 
clude  the  GDR  scalar  points,  if  any  (Output) 

Reduced  g-set  active  acceleration  vectors  for  all  static  aero  subcases  that 
have  active  trim  parameter,  stress,  strain  and/or  displacement  con¬ 
straints.  This  is  a  subset  of  the  columns  of  EAAG  (bc)  ]  and  does  not  in¬ 
clude  the  GDR  scalar  points,  if  any  (Output) 

Partitioning  vector  used  to  obtain  [UGA]  and  [AGA]  from  [UAG(BC)] 
and  [AAG(BC)]  (Output) 

Partitioning  vector  relative  to  [uag(bc)]  and  [aag(BC)]  that  marks 
the  displacement/acceleration  columns  associated  with  subcases  having 
active  stress,  strain  or  displacement  constraints.  This  vector  will  be  iden¬ 
tical  to  [pgaa]  unless  there  are  subcases  in  which  dcontrm  constraints 
are  active  and  no  stress,  strain  or  displacement  constraints  are  active 
(Output) 

An  unstructured  entity  with  one  word  for  each  active  stress,  strain  or  dis¬ 
placement  constraint  in  the  current  subscript  related  subcases.  That 
word  is  the  subcase  number  associated  with  the  constraint  (Output) 

An  unstructured  entity  with  one  word  for  each  element  stress,  strain  or 
displacement  response  function  required  by  the  active  user  function  con¬ 
straints  in  the  current  subscript  related  subcases.  That  word  is  the  sub¬ 
case  number  associated  with  the  response  (Character,Output) 

g-set  pseudodisplacement  vectors  (displacement  fields  due  to  loads  aris¬ 
ing  from  unit  values  of  trim  configuration  parameters)  for  all  aeroelastic 
effectiveness  constraints  (Input),  where  BC  represents  the  MAPOL  boimd- 
ary  condition  loop  index  ninnber 

g-set  pseudoacceleration  vectors  (acceleration  fields  due  to  loads  arising 
from  unit  values  of  trim  configuration  parameters)  for  aU  aeroelastic  effec¬ 
tiveness  constraints  (Input),  where  BC  represents  the  MAPOL  boundary 
condition  loop  index  number 

Logical  flag  that  is  set  to  true  if  there  are  any  active  constraints  that  re¬ 
quire  the  pseudodisplacements  or  pseudoaccelerations.  Those  constraints 
are  DCONALE,  DCONCLA  and  DCONSCP  (Output,  Logical) 

Reduced  g-set  active  pseudodisplacement  vectors  for  all  active  effective¬ 
ness  constraints.  This  is  a  subset  of  the  columns  of  [UAGC  (BC)  ]  and  does 
not  include  the  GDR  scalar  points,  if  any  (Output) 

Reduced  g-set  active  pseudoacceleration  vectors  for  all  active  effective¬ 
ness  constraints.  This  is  a  subset  of  the  columns  of  [AAGC  (BC)  ]  and  does 
not  include  the  GDR  scalar  points,  if  any  (Output) 

An  xmstructured  entity  with  one  word  for  each  active  effectiveness  con¬ 
straint  (DCONALE,  DCONCLA,  DCONSCF)  in  the  current  subscript’s  related 
subcases.  That  word  is  the  column  id  of  the  first  column  associated  with 
the  constraint  (Output) 
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Application  Calling  Sequence: 

None 

Method: 

This  module  treats  two  distinct  families  of  aeroelastic  constraints  for  the  cmrent  boundary  condition 
and  subscript  number:  the  active  aeroelastic  effectiveness  constraints  dconale,  dconcla  and  dconscf; 
and  the  active  displacement  dependent  constraints  DCONTRM,  DCONDSP,  stress  and  strain.  Two  parallel 
sets  of  partitioning  operations  take  place  to  extract  the  active  pseudodisplacements  needed  for  effec¬ 
tiveness  constraints  and  active  displacements  needed  for  the  displacement-dependent  constraints.  The 
control  information  for  the  presence  or  absence  of  each  type  of  constraint  and  the  additional  control 
information  to  extract  data  from  downstream  entities  is  also  prepared  for  each  constraint  family.  Finally, 
the  need  to  loop  through  another  subscript  value  is  determined  and  the  LOOP  variable  is  output.  LOOP 
will  be  false  after  the  last  needed  arosnsdr  call  for  the  current  BC. 

First  CASE  is  queried  to  obtain  the  trim  identification  nvunber  and  symmetry.  Then  TRIM  is  read  to 
obtain  the  subscript  numbers,  MINDEX  values  and  subcase  ids  for  each  SAERO  subcase  in  the  current 
BC.  These  data  are  then  assembled  into  a  master  table  containing  the  trim  identification  number,  the 
subscript  nmnber  and  the  subcase  id. 

The  CONST  relation  is  then  read  to  count  the  number  of  active  stress,  strain,  displacement,  aileron 
effectiveness,  lift  effectiveness,  stability  coefficient  and  trim  parameter  constraints.  A  loop  over  each 
CONST  entry  is  then  made  to  eissemble  the  partitioning  vectors  and  control  information  for  sensitivity 
computations.  Each  family  of  constraints  is  treated  separately. 

For  effectiveness  constraints,  the  DISPCOL  attribute  in  CONST  is  used  to  biuld  a  partitioning  vector  for 
the  active  pseudodisplacements  and  accelerations.  The  partitioning  vector  is  later  destroyed  but  the 
active  column  nmnbers  are  stored  as  a  contiguous  string  of  numbers  and  written  to  PCAE.  For  lift 
effectiveness  constraints  there  is  one  UAGC/AAGC  column  for  each  applied  constraint:  the  disp/accel.  due 
to  a  unit  angle  of  attack.  For  aileron  effectiveness,  there  are  two  columns:  the  first  due  to  unit  control 
surface  deflection  and  the  second  due  to  unit  roll  rate.  For  stability  coefidcients,  there  is  one  colunm  due 
to  a  unit  deflection  of  the  constrained  parameter.  As  the  constraints  are  looped  over,  only  those  with  the 
current  subscript  value  are  considered.  Those  with  lower  subscript  values  have  already  been  processed 
and,  if  any  active  constraints  are  found  with  a  higher  subscript  value,  the  loop  flag  is  set  to  true  to 
ensure  another  pass  is  done. 

A  similar  path  exists  for  the  displacement-dependent  constraints  except  the  matrices  being  partitioned 
are  the  actual  displacement  and  acceleration  fields.  Separate  partitioning  vectors  are  assembled  for  1) 
active  colunms  due  to  aU  displacement  dependent  constraints  (PGAA)  and  2)  active  columns  due  to  stress, 
strain  and  displacement  constraints  (PGUA).  Again,  previously  processed  subscripts  are  ignored  and 
LOOP  is  set  to  true  if  larger  subscripts  are  encountered. 

Finally,  the  assembled  partitioning  vectors  are  written  to  their  respective  entities  and  the  PCAE  and 
PCAA  entities  are  determined  from  the  partitioning  data  and  written  to  the  imstructured  entities.  The 
presence  of  active  constraints  in  the  effectiveness  family  or  displacement-dependent  family  is  then 
known  and  the  ACTAEPF  and  ACTUAG  flags,  respectively,  are  set. 
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The  element  stress  and  strain  responses;  displacement  responses;  aeroelastic  flexible  stability  coeffcient 
responses;  and  trim  parameter  responses  which  are  required  by  active  user  functional  constraints  at 
the  current  boimdary  condition  and  subscript  number  are  treated  in  the  similar  manner  as  those 
corresponding  constraints.  The  subcases  which  have  active  displacement  or  element  stress/strain 
response  functions  are  also  defined  as  active.  The  partitioning  vector,  pgaa,  and  the  set  of  subcase 
UTunbers  that  are  active,  PR2Ut,  are  loaded  if  necessary.  The  actaeff  and  actuag  flags  are  also  set  for 
active  responses. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  AROSNSMR 

Entry  Point:  AROSMR 

Purpose: 

Merges  the  static  aero  sensitivities  for  each  subscript  (stored  in  the  matrix  [MATSUB] )  into  the 
[MATOtJT]  matrix  in  case  order  for  active  subcases  rather  than  subscript  order  for  the  current  active 
boundary  condition. 


MAPOL  Calling  Sequence: 

CALL  AROSNSMR  (  BCID,  SUB,  NDV,  [PGAA] ,  [PCSAU] ,  [MATOUT] ,  [MATSUB]  ) ; 


bcid  User  defined  boimdary  condition  identification  number  (Integer,  Input) 

SUB  Current  static  aeroelastic  subscript  niimber  (Input,  Integer) 


NDV 


Number  of  design  variables  (Input,Integer) 


[PGAA] 

[PGAU] 


[MATOOT] 


[MATSUB] 


Partitioning  vector  used  denoting  active  displacement  fields  for  the  cur¬ 
rent  boimdary’s  static  aeroelastic  subcases  (Input) 

Partitioning  vector  used  denoting  active  displacement  fields  that  are  ac¬ 
tive  due  only  to  stress,  strain  and  displacement  constraints  for  the  cur¬ 
rent  boimdarys  static  aeroelastic  subcases  (Input) 

On  input,  MATOUT  must  contain  the  merged,  reordered  displacement  or 
acceleration  sensitivities  for  all  the  subcases  processed  for  the  earher  sub¬ 
script  values.  On  output  the  SUB’th  subscript  is  included.  This  matrix  will 
contain  one  column  for  each  active  vector  for  the  1st  design  variable,  fol¬ 
lowed  by  another  set  for  the  second  and  so  on.  The  order  of  the  vectors 
within  each  variable’s  set  will  be  the  order  of  the  SAERO  subcases  in  the 
CASE  relation  (Input  and  Output) 

The  input  matrix  of  displacement  or  acceleration  sensitivities  for  all  the 
subcases  processed  for  the  SUB’th  subscript.  This  matrix  will  contain  one 
column  for  each  active  vector  associated  with  the  SUB’th  subscript  for  the 
1st  design  variable,  followed  by  another  set  for  the  second  and  so  on.  The 
order  of  the  vectors  within  each  variable’s  set  will  be  the  order  of  the 
TRIM  ids  appearing  in  the  trim  relation  associated  with  the  SUB’th  sub¬ 
script  value  (Input) 


Application  Calling  Sequence: 

None 

Method: 

First  the  CASE  relation  is  read  to  retrieve  the  trim  id’s  for  the  saero  subcases  in  the  current  boundary 
condition.  The  the  trim  relation  is  read  to  obtain  the  subcase  numbers  associated  with  each  trim  id 
having  the  current  SUBscript  value.  Then  the  PGAA  and  PGUA  vectors  are  read  into  memory  to  assist  in 
the  partitioning  operation. 

Then  the  MATSUB  and  MATOUT  matrices  are  opened.  If  MATOUT  is  uninitialized  or  if  SUB  =  1,  it  is 
initialized  (flushed  and  the  number  of  rows,  precision  and  form  set  to  those  of  MATSUB.  If  MATOUT 
already  exists  and  has  data  in  it,  a  scratch  matrix  is  created  to  hold  the  final  merged  data. 


103 


For  each  design  variable  in  the  model,  each  saero  case  entry  for  the  current  boundary  is  processed. 
For  each  CASE  entry,  the  partitioning  vector  pgaa  is  used  to  determine  if  it  is  active  and  therefore  may 
have  a  column  in  either  matsub  or  matout.  For  the  active  subcase  id,  the  trim  data  are  searched  to 
determine  the  subscript  number  associated  with  the  subcase.  If  the  subscript  is  less  than  StJB,  a  column 
from  MATOUT  may  be  taken  (if  it  was  stored  there  on  an  earlier  pass).  If  the  subscript  is  equal  to  SUB, 
it  may  be  stored  on  the  output  matrix  from  MATSUB.  If  greater  than  SUB,  it  is  ignored  till  later  passes. 

Once  a  column  is  identified  as  active  in  MATSUB  (PGAA  indicates  active  and  subscript  =  SUB),  an 
additional  check  is  made  to  see  if  the  column  is  active  in  PGUA.  Only  those  columns  that  are  active  in 
PGUA  are  copied  to  matout.  This  filtering  is  done  to  limit  the  amoimt  of  computational  effort  in  the 
stress,  strain  and  displacement  constraint  sensitivity  computations  that  proceed  using  the  MATOUT 
matrix.  The  matsub  columns  that  are  active  due  to  dcontrm  constraints  are  no  longer  needed  as  these 
sensitivities  are  assumed  to  have  been  computed  already  in  the  AEROSENS  module. 

Once  the  final  matrix  is  formed,  if  MATOtJT  had  had  data  in  it,  the  name  of  the  scratch  matrix  tibat  was 
loaded  is  switched  with  that  of  matout.  The  scratch  entity  is  then  destroyed. 

Design  Requirements: 

1.  The  assumption  is  that  each  MATSUB  matrix  contains  the  results  from  the  "suB"th  subscript  value  in 
the  order  of  the  trim  id’s  for  that  SUB  appear  in  the  trim  relation. 

2.  The  same  MATOUT  matrix  must  be  passed  into  the  arosmsmr  module  on  each  call  since  the  columns 
associated  with  earher  subscript  values  are  read  from  MATOUT  into  a  scratch  entity.  The  merged  matrix 
that  results  then  replaces  the  input  MATOUT. 

3.  The  AEROSENS  module  is  called  upstream  of  the  arosnsmr  module  to  process  active  DCONTRM 
constraints  for  the  current  subscript.  Thus,  those  columns  that  are  active  only  for  dcontrm  constraints 
may  be  filtered  out  for  the  downstream  processing  of  stress,  strain  and  displacement  constraints. 

Error  Conditions: 

None 
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Engineering  Application  Module:  bcbgpdt 

Entry  Point:  BCBGPD 

Purpose: 

Builds  the  boundary  condition-dependent  grid  point  coordinate  relation  BGPDT  for  the  specified  boiand- 
ary  condition. 

MAPOL  Calling  Sequence: 

CALL  BCBGPDT  (  BCID, 

BCID 
GSIZEB 

BGPDT (BC) 

ESIZE(BC) 

Application  Calling  Sequence: 

None 
Method: 

The  invarient  basic  grid  point  data  is  read  from  the  BGPDT  relation  (an  unsubscripted  relation  that  is 
formed  in  IFP).  The  user’s  extra  points  selected  in  the  CASE  relation  are  then  appended  in  memory  and 
sorted  on  external  id.  Uniqueness  of  the  external  id’s  are  checked  and  the  new  BGPDT  (BC)  is  written. 

Design  Requirements: 

1.  The  invariant  BGPDT  must  exist  on  the  data  base.  It  is  a  hidden  output  from  the  IFP  module. 

Error  Conditions: 

1.  Nonunique  GRID/EPOINT  id’s  are  flagged. 


GSIZEB,  BGPDT (BC),  ESIZE(BC)  ); 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

Basic  g-set  size  (the  size  independent  of  GDR-added  scalar  points) 
(Integer,  Input) 

Relation  of  basic  grid  point  data  for  the  boundary  condition  (including 
any  extra  points  but  excluding  GDR  scalar  points  which  may  be  added  by 
the  GDR  module)  (Output),  where  BC  represents  the  MAPOL  boundary 
condition  loop  index  munber 

Number  of  extra  point  DOF  defined  for  the  boimdary  condition 
(Integer,  Output),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 


Engineering  Application  Module:  BCBULK 


Entry  Point:  BCBULK 


Purpose: 

Builds  boundary  condition-dependent  matrices,  transfer  functions,  and  initial  conditions. 
MAPOL  Calling  Sequence: 

CALL  BCBULK  (  BCID,  PSIZE(BC),  BGPDT(BC),  USET{BC)  ); 


BCID 

PSIZE(BC} 

BGPDT(BC) 

USET(BC) 


User  defined  boxmdary  condition  identification  number  (Integer,  Input) 

The  size  of  the  physical  set  for  the  current  boundary  condition  (Integer,  Input), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number 

The  relation  of  basic  grid  point  data  for  the  current  BC  (including  any  se¬ 
lected  extra  points)  (Input),  where  BC  represents  the  MAPOL  boundary 
condition  loop  index  number 

The  imstructured  entity  of  DOF  masks  for  all  the  points  in  the  current 
boundary  conditions  (Input),  where  BC  represents  the  MAPOL  boundary 
condition  loop  index  number 


Application  Calling  Sequence: 
None 


Method: 

All  the  outputs  from  this  routine  are  hidden  —  meaning  that  they  do  not  appear  in  the  call.  The  purpose 
of  this  module  is  to  assemble  those  data  that  depend  on  the  boimdary  condition  selection  of  extra  points. 

For  the  data  of  each  type  that  is  referenced  in  CASE  for  the  current  boundary  condition,  the  data  are 
retrieved  from  the  bulk  data  relations  that  were  loaded  in  IFP  and  are  error  checked  relative  to  the  set 
of  DOF  that  comprise  the  current  boundary  condition.  The  following  hidden  entities  are  output: 


BULK  DATA 

SUBROUTINE 

GENERATED  ENTITY 

DLONLY 

PREDOL 

UDLOLY  1 

DMIG 

PREDMG 

named  matrix  entities  | 

TF 

PRETF 

TFDATA  1 

IC 

PREIC 

I CD AT A  1 

In  each  case,  these  entities  contain  only  those  data  that  relate  to  the  current  boundary  condition.  They  will 
be  replaced  in  subsequent  boimdaiy  conditions  and/or  iterations  with  the  appropriate  data  on  each  pass. 

Design  Requirements: 

None. 

Error  Conditions: 

1.  Initial  error  checking  of  each  bulk  data  entry  t3rpe  is  performed  within  this  module. 
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Engineering  Application  Module:  BCEVAL 


BCEVAL 


Evaluates  the  current  values  of  BAR  element  cross-sectional  dimension  relationship  constraints. 
MAPOL  Calling  Sequence: 

CALL  BCEVAL  (  NITER,  NDV,  GLBDES,  LOCLVAR,  [PTRANS] ,  CONST  ); 

NITER  Design  iteration  niomber  (Integer, Input) 

NDV  Number  of  design  variables  (Integer, Input) 

GLBDES  Relation  of  global  design  variables  (Character,Input) 


LOCLVAR 


[PTRANS] 


CONST 


Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Character,Input) 

The  design  variable  linking  matrix  (Character,Input) 

Relation  of  constraint  values  (Character,Output) 


Application  Calling  Sequence: 


Method: 


This  module  analyzes  each  designed  BAR  element  which  uses  PBARl  property  Bulk  Data  to  define  its 
cross-sectional  parameters.  A  set  of  cross-sectional  parameter  relationship  constraints  are  computed 
based  on  the  BAR  element  cross-sectional  shape.  Constraints  for  these  relationships  are  formulated  as 
follows: 

"I"  Shape: 

G1  =  (  D3  +  D4  -  D2  )  /  (  2*DMAX  )  and 

G2  =  (  D5  -  D1  )  /  DMAX;  where  DMAX  =  MAX(D1,D2,D3,D4,D5) 

"T"  Shape: 

G1  =  (  D4  -  D1  )  /  DMAX  and 

G2  =  (  D3  -  D2  )  /  DMAX;  where  DMAX  =  MAX(D1,D2,D3,D4) 

"BOX"  Shape: 

G1  =  {  2*D3  -  D1  )  /  {  2*DMAX  )  and 

G2  =  (  2*D3  -  D2  )  /  (  2*DMAX  );  where  DMAX  =  MAX(Dl,D2,D3) 

"TUBE"  Shape: 

G1  =  {  D2  -  0.5*D1  )  /  DMAX;  where  DMAX  =  MAX(D1,D2) 


"HAT"  Shape: 

G1  =  (  D3  -  D1  )  /  DMAX  and 

G2  =  {  2*D4  -  D3  )  /  (  2*DMAX  )  and 

G3  =  {  2*D4  +  D5  -  D2  )  /  {  3*DMAX  );  where  DMAX  =  MAX(D1,D2,D3,D4,D5) 
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"GBOX"  Shape: 

G1  =  (  2*D5  +  D6  -  D1  )  /  (  3*DMAX) 

G2  =  {  D3  +  D4  -  D2  )  /  (  2*DMAX  );  where  DMAX  =  MAX(D1,D2,D3,D4,D5,D6) 
Note  that  Dl,  D2,  D3,  D4,  D5,  and  D6  are  BAR  element  cross-sectional  parameters. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  BCIDVAL 
Entry  Point:  BCIDVL 


Purpose: 

Converts  the  boundary  condition  index  number  (BC)  into  the  boundary  condition  identification  number 

(BCID). 

MAPOL  Calling  Sequence: 

CALL  BCIDVAL  (  BC,  CASE,  BCID  ); 

BC  MAPOL  boimdary  condition  loop  index  number  (Integer,Input) 

case  Relation  containing  the  case  parameters  for  each  subcases  within  each 

boundary  condition  (Character, Input) 

BCID  User  defined  boundary  condition  identification  number  (Integer,  Input) 


Application  Calling  Sequence: 

None 

Method: 

This  modiile  counts  the  boundary  contion  number  through  CASE  entries  and  obtains  the  corresponding 
boundary  condition  identification  number  BCID  from  CASE  for  the  input  boundary  condition  index 
number  BC. 

Design  Requirements: 

None 

Error  Conditions: 

BCID  =  -lifrelation  CASE  is  nonexistent  or  empty. 
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Engineering  Application  Module ;  BLASTDRV 

Entry  Point:  BLSDRV 


Piirpose: 

To  compute  an  aircraft’s  transient  response  to  a  nuclear  blast. 

MAPOL  Calling  Sequence: 

CALL  BLASTDRV  (  BC,  [GENM]  ,  [GENK] ,  [GENFA] ,  [GENQL] ,  [DELB]  ^  [XnODB] , 
[DWNWSH],  [SLPMOD],  [ELAS] ,  [UBLASTI]  ); 


BC  MAPOL  boundary  condition  loop  index  number  (Integer, Input) 

[GENM]  Generalized  mass  matrix  (Input) 

[GENK]  Generalized  stifl&iess  matrix  (Input) 

[GENFA]  Mode  on  box  generalized  forces  (Input) 

[GENQL]  Mode  on  box  aeroelastic  corrections  (Input) 

[DELB]  Trim  vector  of  initial  conditions  (Input) 

[URDB]  Vector  of  initial  accelerations  (Input) 

[DWNWSH]  Matrix  of  downwash  vectors  for  unit  angle  of  attack  and  elevator  (Input) 

[SLPMOD]  Matrix  of  slopes  at  box  centers  due  to  structural  modes  (Input) 

[ELAS]  Matrix  of  initial  modal  displacements  (Input) 

[tJBLASTI]  Matrix  of  blast  response  vectors.  For  each  time  step,  displacement,  veloc¬ 

ity  and  acceleration  vectors  are  stored  (Output) 


Dlication  Callinsr  Sequence: 


None 


Method: 

The  module  obtains  solution  control  information  from  the  CASE  relation,  the  reference  chord  from  AERO 
and  blast  parameters  from  BliAST.  GENF,  GENQL,  DWNWSH,  SLPMOD  and  aerodynamic  geometry  data 
are  read  into  core.  Initial  conditions  are  set  up  and  a  call  to  subroutine  AST6AS/D  initiahzes  the  blast 
calculation.  The  TSTEP  data  are  then  read  in  and  a  call  to  XBLSTS/D  calculates  the  blast  intercept  time. 
Initial  response  vectors  are  written  to  the  ublasti  matrix  and  a  call  to  subroutine  blvels/d  calculates 
the  downwash  at  the  aerodynamic  boxes  and  a  call  to  AST6AS/D  gets  the  initial  load.  Aloop  on  the  time 
steps  is  then  begun.  A  Newmark-Beta  algorithm  is  applied  to  calculate  the  transient  response.  Within 
the  time  loop,  calls  to  BLVELS/d  and  AST6AS/D  determine  the  downwash  vector  and  the  response, 
respectively.  Data  are  written  to  UBLASTI  as  specified  by  the  TSTEP  input.  Once  all  the  time  steps  have 
been  computed,  scratch  entities  are  destroyed  and  control  is  returned  to  the  executive. 
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Error  Conditions: 
None 
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Engineering  Application  Module:  BLASTFIT 


Entry  Point:  inTRF 


Purpose: 

lb  compute  the  interpolated  time  domain  steady  state  and  time  dependent  aerod3nnamic  influence 
coefficients  for  blast  analyses  based  on  imsteady  aerodynamics  computed  in  the  time  domain. 

MAPOL  Calling  Sequence: 

CALL  BLASTFIT  (  BCID,  [QJJL] ,  [MATTR] ,  [MATSS] ,  BQDP,  [BFRC] ,  [DWNWSH] , 

HSIZE(BC),  [ID2],  [MPART],  [UGTKA] ,  [BLGTJA] ,  [BLSTJA]  ); 


BCID 

[QJJL] 

[MATTR] 

[MATSS] 

BQDP 

[BFRC] 

[DWMWSH] 

ESIZE(BC) 

[ID2] 

[MPART] 

[UGTKA] 

[BLGTJA] 

[BLSTJA] 


User  defined  boundary  condition  identification  number  (Integer,  Input) 

Aerodynamic  influence  coefficient  matrices  in  the  frequency  domain 
(Input) 

Aerod5mamic  influence  coefficient  matrix  list  in  the  time  domain  (Output) 
Steady  stat  aerodynamic  influence  coefficient  matrix  (Output) 

Blast  dynamic  pressure  (Real,  Output) 

Matrix  of  aerodynamic  forces  due  to  specified  rigid  body  motions  (Output) 

Matrix  of  downwash  components  due  to  specified  rigid  body  motions 
(Output) 

Number  of  normal  modes  to  be  used  in  the  analysis  (Integer,  Output), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number 

An  identity  matrix  required  for  performing  trim  analysis  in  the  MAPOL 
sequence  (Output) 

A  partitioning  vector  required  for  performing  trim  analysis  in  the 
MAPOL  sequence  (Output) 

Unsteady  spline  matrix  (Input) 

Spline  matrix  for  transforming  blast  forces  (Output) 

Spline  matrix  for  transforming  displacements  and  slopes  (Output) 


Application  Calling  Sequence: 

None 

Method: 

Problem  parameters  are  first  obtained  fi*om  the  CASE,  AERO  and  BLAST  entities.  A  call  to  ATMOS 
determines  the  dynamic  pressure  for  the  specified  flight  condition.  A  list  of  reduced  frequencies  that  are 
available  for  the  specified  Mach  number  is  retrieved.  A  grand  loop  on  the  number  of  sending  boxes  is 
begun  with  a  call  to  DLINDX  to  determine  the  geometry  of  the  sending  box.  A  secondary  loop  on  the 
receiving  box  starts  with  a  call  to  READDL  to  extract  the  QJJL  coefficients  for  the  receiving  and  sending 
boxes  for  all  the  reduced  frequencies.  These  data  are  then  processed  using  the  algorithm  described  in 
Appendix  B  of  the  Theoretical  Manual  to  compute  time  domain  coefficients.  Once  all  the  receiving  boxes 
have  been  computed,  a  column  of  MATSS  is  written  and  NBETA  columns  are  written  to  scratch  matrix 
BLSSCR.  Once  the  loop  on  sending  boxes  has  been  completed,  the  blsscr  data  are  retrieved  in  the  order 
that  they  are  required  in  mattr  and  this  output  matrix  is  written.  A  call  to  BLSFRS/D  computes  matrices 
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required  in  the  trim  analysis.  Downwash  vectors  for  given  aircraft  parameters  (such  as  angle  of  attack) 
are  computed  and  stored  to  dwnwsh.  Premultiplication  of  the  downwash  vector  by  the  matss  ma^ 
computes  the  forces  due  to  the  aircraft  parameters  and  these  data  are  stored  in  blsfrs/d.  Matrices 
ID2  and  MPART  are  created  and  the  UGTKA  matrix  is  partitioned  into  blgt  JA  and  blst  JA.  Control  is 
then  returned  to  the  driver  subroutine  and  then  to  the  executive. 

Design  Requirements: 

1.  Must  follow  the  amp  module.  It  it  is  convenient  to  group  this  module  with  the  blasttrim  and 
BLASTDRY  modules  since  they  rely  on  BIASTFIT  outputs. 

Error  Conditions: 

None 
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Engineering  Application  Module:  BLASTRIM 

Entry  Point:  BLSTRU 

Purpose: 

Performs  a  trim  analysis  prior  to  performing  a  transient  response  to  a  nuclear  blast. 
MAPOL  Calling  Sequence: 

CALL  BLASTRIM  {  BCID,  [DELM] ,  [MRR(BC) ] ,  [URDB] ,  [DELB]  ); 


BCID 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

BC 

Boundary  condition  index  number  (Integer,  Input) 

[DELM] 

Matrix  of  applied  loads  (Input) 

[MER(BC)] 

Reduced  mass  matrix  (Input) 

[URDB] 

Matrix  of  aircraft  accelerations  (Output) 

[DELB] 

Matrix  of  trim  parameters  (Output) 

Application  Calling  Sequence; 

None 

Method: 

The  DELM  and  MRR  matrices  are  read  into  core,  the  BLAST  identification  number  is  retrieved  from  the 
CASE  entity  and  the  corresponding  blast  parameters  are  read  from  the  BLAST  entity.  The  trim  equations 
are  then  solved  and  the  acceleration  and  trim  vectors  are  written  to  URDB  and  delb,  respectively. 

Design  Requirements: 
None 


Error  Conditions: 
None 
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Engineering  Application  Module :  BOUND 

Entry  Point:  BOUND 

Purpose: 


lb  return  flags  to  the  MAPOL  sequence  that  define  the  matrix  reduction  path  for  the  current  boundary 
condition. 


MAPOL  Calling  Sequence: 

CALL  BOUND  (  BCID,  GSIZE,  ESIZE(BC)/  USET(BC),  BLOAD,  BMASS/  DMODES/  BMODES, 
BSAERO,  BFLUTR,  BDYN,  BDRSP,  BDTR,  BMTR,  BDFR,  BMFR,  BGUST, 
BBLAST/  NMPC,  NSPC,  NOMIT,  NRSET,  NGDR  ); 

BCID  User  defined  boundary  condition  identification  number  (Integer,  Input) 

GSIZE  The  number  of  degrees  of  freedom  in  the  structural  set  (Integer,  Input) 


ESIZE(BC) 

USET{BC) 

BLOAD 

BMASS 

DMODES 

BMODES 

BSAERO 

BFLUTR 

BDYN 

BDRSP 

BDTR 

BMTR 

BDFR 

BMFR 


The  number  of  extra  point  degrees  of  freedom  in  the  boundary  condition 
(Integer,  Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

The  unstructured  entity  defining  structural  sets  (Character,  Input), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number 

Static  load  flag;  =1  if  any  static  loads  in  the  current  boundary  condition 
(Integer,  Output) 

Mass  matrix  flag;  =1  if  the  mass  matrix  is  needed  for  any  discipline(s)  in 
the  current  boimdary  condition  (Integer,  Output) 

Modes  discipline  flag;  =1  if  any  modal  dynamic  response  discipline(s) 
(Integer,  Output) 

Modal  analysis  flag;  =1  if  any  disciplines  in  the  current  boxmdary  condi¬ 
tion  require  that  a  real  eigenanalysis  be  performed  (Integer,  Output) 

Static  aeroelastic  flag;  =1  if  any  static  aeroelastic  analyses  are  in  the  cur¬ 
rent  boundary  condition  (Integer,  Output) 

Flutter  discipline  flag;  =1  if  any  flutter  analyses  in  the  current  boundaiy 
condition  (Integer,  Output) 

Dynamics  flag;  =1  if  any  disciplines  requiring  dynamic  matrix  assembly 
are  in  the  current  boundary  condition  (Integer,  Output) 

Dynamic  response  flag;  =1  if  any  transient  or  frequency  response  analy¬ 
ses  in  the  current  boundary  condition  (Integer,  Output) 

Direct  Transient  Response  flag;  =1  if  any  direct  transient  response  analy¬ 
ses  are  in  the  current  boxmdary  condition  (Integer,  Output) 

Modal  Transient  Response  flag;  =1  if  any  modal  transient  response  analy¬ 
ses  are  in  the  current  boxmdary  condition  (Integer,  Output) 

Direct  Frequency  Response  flag;  =1  if  any  direct  frequency  response 
analyses  are  in  the  current  boxmdary  condition  (Integer,  Output) 

Modal  Frequency  Response  flag;  =1  if  any  modal  frequency  response 
analyses  are  in  the  current  boxmdary  condition  (Integer,  Output) 
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BGUST  Gust  option  flag;  -1  if  any  dynamic  response  disciplines  include  the  gust 

option  in  the  current  boundary  condition  (Integer,  Output) 

BBLAST  Blast  discipline  flag;  =1  if  any  blast  analyses  are  in  the  current  boundary 

condition  (Integer,  Output) 

NMPC  Number  of  degrees  of  freedom  in  the  m-set,  (Integer,  Output) 

NSPC  Number  of  degrees  of  freedom  in  the  s-set,  (Integer,  Output) 

NOMIT  Number  of  degrees  of  freedom  in  the  o-set,  (Integer,  Output) 

NRSET  Number  of  degrees  of  freedom  in  the  r-set,  (Integer,  Output) 

NGDR  Denotes  d3mamic  reduction  in  the  boundaiy  condition. 

=  0  No  GDR 
=  -1  GDR  is  used 
(Output,  Integer) 


Application  Calling  Sequence: 

None 

Method: 

The  USET  entity  and  CASE  relation  are  read  to  determine  the  sizes  of  the  dependent  structural  sets  and 
to  ensure  that  no  illegal  combinations  of  disciplines  and  matrix  reduction  methods  reside  in  the  same 
boundary  condition.  The  matrix  reductions  and  analysis  steps  in  the  standard  MAPOL  sequence  are 
then  guided  by  the  flags  from  bound.  A  summary  of  the  structural  sets  is  printed  to  the  output  file 
followed  by  a  summary  of  the  disciplines  and  subcases  that  have  been  selected. 

Design  Requirements: 

1.  The  CASE  relation  must  be  filled  with  the  information  from  the  Solution  Control  Packet  by  the 
SOLUTION  module.  Also,  the  mkuset  module  must  have  loaded  the  USET  entity. 

Error  Conditions: 

None 
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Engineering  Application  Module:  BOUNDUPD 

Entry  Point:  BOUNDUPD 

Purpose: 

To  echo  the  updated  boundary  condition  summary. 

MAPOL  Calling  Sequence: 

CALL  BOUNDUPD  (  BCID,  GSIZE,  ESIZE(BC),  USET(BC) ,NSPC,  NOMIT,  NRSET  ); 


BCID 

GSIZE 

ESIZE(BC) 


User  defined  boundary  condition  identification  number  (Integer,  Input) 
The  niunber  of  degrees  of  freedom  in  the  structural  set  (Integer,  Input) 


USET(BC) 


NSPC 

NOMIT 

NRSET 


The  number  of  extra  point  degrees  of  freedom  in  the  boundary  condition 
(Integer,  Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number. 

The  unstructured  entity  defining  structural  sets  (Character,  Input), 
where  BC  represents  the  MAPOL  boimdary  condition  loop  index  number. 

Number  of  degrees  of  freedom  in  the  s-set,  (Integer,  Output) 


Number  of  degrees  of  freedom  in  the  o-set,  (Integer,  Output) 
Number  of  degrees  of  freedom  in  the  r-set,  (Integer,  Output) 


Application  Calling  Sequence: 
None 


Method: 

The  USET  entity  and  CASE  relation  are  read  to  determine  the  sizes  of  the  dependent  structural  sets  and 
to  ensure  that  no  illegal  combinations  of  disciplines  and  matrix  reduction  methods  reside  in  the  same 
boundary  condition.  The  matrix  reductions  and  analysis  steps  in  the  standard  MAPOL  sequence  are 
then  guided  by  the  flags  from  BOUND.  A  siniunary  of  the  structural  sets  is  printed  to  the  output  file 
followed  by  a  summary  of  the  disciplines  and  subcases  that  have  been  selected. 


Design  Requirements: 

1.  The  CASE  relation  must  be  filled  with  the  information  from  the  Solution  Control  Packet  by  the 
SOLUTION  module.  Also,  the  mkuset  module  must  have  loaded  the  uset  entity. 


Error  Conditions:  None 
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Engineering  Application  Module :  CONORDER 


Entry  Point:  CONORD 

Purpose: 

Reorders  active  constraints  in  boundary  condition  order  to  match  the  order  in  which  constraint 
sensitivities  are  computed. 

MAPOL  Calling  Sequence: 

CALL  CONORDER  (  NITER/  NUMOPTBC/  CASE,  CONST/  CONSTORD  ) ; 


NITER 

NUMOPTBC 

CASE 

CONST 

CONSTORD 

Application  Calling  Sequence: 
None 


Design  iteration  number  (Integer, Input) 

Number  of  optimization  boundary  conditions  (Integer, Input) 

Relation  containing  the  case  parameters  for  each  subcases  within  each 
boundary  condition  (Character, Input) 

Relation  of  constraint  values  (Character, Input) 

Relation  of  reordered  constraint  values  (Character, Output) 


Method: 

This  module  first  gets  boundary  condition  independent  active  constraints  (thickness  constraints, 
cross-sectional  parameter  constraints  for  BAR's,  and  laminate  gauge  constraints)  from  relation  CONST 
and  put  them  into  the  new  relation  CONSTORD.  Then,  for  each  optimization  boundary  condition,  active 
frequency  and  flutter  constraints  are  boundary  condition  dependent,  but  not  subcase  dependent, 
therefore  they  precede  any  subcase  dependent  constraints  for  the  current  boundary  condition  in  relation 
CONSTORD.  liiereafter:  active  STATICS  displacement  and  stress/strain  constraints  are  placed  in  subcase 
order;  active  SAERO  aeroelastic  effectiveness  and  stability  coefficient  constraints,  trim  parameter 
constraints  are  placed  in  subscript  order;  and  active  SAERO  displacement  and  stress/strain  constraints 
are  placed  in  subcase  order.  Finally,  active  panel  buckling  constraints  and  Euler  buckling  constraints 
are  placed  in  subcase  order  in  relation  CONSTORD. 

Design  Requirements: 

Since  the  reordered  constraint  relation  CONSTORD  is  required  by  module  OFPGRAD  and  DESIGN,  module 
CONORDER  must  be  called  prior  to  those  modules  and  after  module  ACTCON.  Module  CONORDER  must  be 
placed  at  the  outside  of  optimization  boimdary  condition  loop. 

Error  Conditions: 

None 
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Engineering  Application  Module:  DCEVAL 
Entry  Point:  DCEVAL 


Purpose: 

Tb  evaluate  displacement  constraints  in  the  current  boundary  condition. 


MAPOL  Calling  Sequence: 

CALL  DCEVAL  (  NITER,  BCID,  [UG{BC)],  BGPDT{BC),  CONST,  BSAERO  ); 


NITER 

BCID 


Design  iteration  number  (Integer,  Input) 

User  defined  boundary  condition  identification  number  (Integer,  Input) 


[UG{BC)] 


BGPDT(BC) 

CONST 


Matrix  of  displacement  vectors  in  the  g-set  for  the  boimdary  condition 
(Input),  where  BC  represents  the  MAPOL  boundary  condition  loop  index 
number. 

Relation  of  basic  grid  point  coordinate  data  (Character,  Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number. 

Relation  of  constraint  values  (Character,  Input) 


Static  aeroelastic  flag;  =1  if  this  call  is  associated  with  static  aeroelastic 
analyses.  (Optional,  Integer,  Input) 


Application  Calling  Sequence: 
None 


Method: 

The  module  first  determines  if  there  are  any  dconst  options  for  a  static  (bsaero=0)  or  SAERO 
(BSAERO=l)  discipline  for  the  cvurent  boundary  condition  and  terminates  if  there  are  none.  If  there  are, 
a  loop  is  made  through  all  the  subcases  for  the  current  boimdary  condition  and  the  necessary 
displacement  constraint(s)  are  calculated  and  written  to  the  CONST  relation.  Finally,  the  displacement 
responses  which  are  re(juired  by  any  user  fimctional  constraints  are  computed. 

Design  Requirements: 

1.  This  module  appears  within  the  analysis  portion  of  the  OPTIMIZE  segment  of  the  MAPOL  sequence. 
It  is  within  the  analysis  boimdary  condition  loop  and  must  follow  the  recovery  of  the  displacement  vector 
to  the  g-set. 

Error  Conditions: 

None 
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Engineering  Application  Module:  DDLOAD 

Entry  Point:  DDLOAD 

Purpose: 

To  compute  the  sensitivities  of  design  dependent  loads  for  active  boundary  conditions. 
MAPOL  Calling  Sequence: 

CALL  DDLOAD  (  NDV,  GSIZEB,  BCID,  SMPLOD,  [DPTHVI] ,  [DPGRVI] ,  [DDPTHV] , 
[DDPGRV],  DDFLG,  [PGAS] ,  [DPVJ]  ); 


NDV 

GSIZEB 

BCID 

SMPLOD 

[DPTHVI] 

[DPGRVI] 

[DDPTHV] 

[DDPGRV] 

DDFLG 

[PGAS] 

[DPVJ] 


The  number  of  global  design  variables  (Integer,  Input) 

The  size  of  the  structural  set  (Integer,  Input) 

User  defined  boimdary  condition  identification  number  (Integer,  Input) 

Unstructured  entity  of  simple  load  vector  information  (Input) 

Matrix  entity  containing  the  linearly  designed  thermal  loads 
(Character,  Input) 

Matrix  entity  containing  the  linearly  designed  gravity  loads 
(Character,  Input) 

Matrix  entity  containing  the  nonlinear  thermal  load  sensitivity 
(Character,  Input) 

Matrix  entity  containing  the  nonlinear  gravity  load  sensitivity 
(Character,  Input) 

Design  dependent  load  flag:  (Integer,  Output) 

=  0  if  no  design  dependent  loads 
=  1  if  any  static  loads  are  design  dependent 

Matrix  entity  containing  a  partitioning  vector  of  active  apphed  static  load 
conditions  (Input) 

Matrix  entity  containing  the  senstivities  of  each  active  static  load  to  the 
design  variables  (Output) 


Apphcation  Calling  Sequence: 

None 

Method: 

The  module  first  determines  if  there  are  any  static  loads  and  if  any  of  the  applied  static  loads  are  potentially 
design  dependent.  This  is  done  by  reading  the  SMPLOD  entity  and  checking  if  any  gravity  or  thermal  loads 
are  defined.  If  any  design  dependent  apphed  loads  are  foimd,  the  module  continues  by  reading  the 
remainder  of  the  first  SMPLOD  record,  the  CASE  relation  for  all  statics  disciplines  in  the  current  active 
boundary  condition  and  all  the  load  relational  tuples.  Finally,  the  PGA  vector  is  brought  into  core  to 
allow  the  active  loads  to  be  identified.  Once  all  the  data  are  in  core,  the  PGA  data  are  used  to  identify 
the  active  static  loads.  For  each  active  load,  the  CASE  relation  is  searched  to  determine  if  any  of  the 
simple  loads  comprising  the  current  active  load  are  design  dependent.  This  involves  the  LOAD  relational 
data  for  MECH  loads  since  the  LOAD  data  may  refer  to  gray  loads  which  are  design  dependent.  If  any 
design  dependent  loads  are  found,  their  sensitivities  are  computed  using  the  DPGRVI,  DDPGRV,  DPTHVI 
and/or  DDPTHV  matrix  entities  of  simple  load  sensitivities.  The  DPVJ  entity  is  loaded  as  active  design 
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dependent  loads  are  encountered  with  care  taken  that  all  active  loads  (including  design  independent 
loads)  are  accounted  for  in  the  column  dimension  of  the  matrix  entity. 

Design  Requirements: 

1.  This  module  must  be  called  to  initialize  the  ddflg  flag  that  is  used  by  the  MAPOL  sequence  to 
direct  subsequent  matrix  operations  relating  to  the  load  sensitivities  even  if  no  design  dependent 
loads  exist  in  the  boundary  condition. 

2.  The  module  assumes  that  at  least  one  active  static  applied  load  exists  in  the  current  boundary  condition. 
Error  Conditions: 

None 
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Engineering  Application  Module:  DESIGN 

Entry  Point:  DESIGN 

Purpose: 


lb  perform  redesign  by  math  programming  methods  based  on  the  current  set  of  active  constraints  and 
constraint  sensitivities. 


MAPOL  Calling  Sequence: 

CALL  DESIGN  (  NITER,  NDV,  APPCNVRG,  MOVLIM,  CNVRGLIM,  CTL,  CTLMIN, 
GLBDES,  CONST,  CONSTORD,  [AMAT] ,  DESHIST  ); 


NITER 

NDV 

APPCNVRG 

MOVLIM 

CNVRGLIM 

CTL 

CTLMIN 

GLBDES 

CONST 

CONSTORD 

[AMAT] 

DESHIST 


Design  iteration  number  (Integer,  Input) 

The  number  of  design  variables  (Integer,  Input) 

The  approximate  problem  converge  flag  (Logical,  Output) 

=  FALSE  if  not  converged 
=  TRUE  if  converged  in  objective  function  value 

Limit  on  how  much  a  design  variable  can  move  for  this  iteration  (Real,  In¬ 
put) 

Tolerance  for  indicating  approximate  problem  convergence  (Real,  Input) 
Tolerance  for  indicating  an  active  constraint  (Real,  Output) 

Tolerance  for  indicating  a  violated  constraint  (Real,  Output) 

Relation  of  global  design  variables  (Character,  Input) 

Relation  of  constraint  values  (Character,  Input) 

Relation  of  reordered  constraint  values  (Character,  Input) 

Matrix  of  constraint  sensitivities  (Input) 

Relation  of  design  iteration  information  (Character,  Output) 


Application  Calling  Sequence: 

None 

Method: 

The  module  first  brings  design  variable,  objective,  constraint,  objective  sensitivity  and  constraint 
sensitivity  information  into  core.  Calls  to  ADS  then  invoke  the  mathmatical  programming  algorithm 
which  performs  the  redesign  task.  Fimction  evaluations  and  gradient  evaluations  that  are  required  as 
part  of  the  math  programming  task  are  performed  by  subroutines  feval  and  greval,  respectively. 

For  a  user  defined  objective  function  and  user  function  constraints,  all  required  response  functions  and 
their  sensitivities  are  computed  prior  to  this  module.  This  module  computes  user  function  values  and 
sensitivities  by  calling  the  user  function  evaluation  utilities  in  subroutines  FEVAL  and  GREVAL, 
respectively. 

Once  the  appoximate  optimizaton  process  is  complete,  the  glbdes  relation  is  updated  with  the  new 
values  of  the  design  variables  and  a  new  entry  is  written  to  the  DESHIST  relation. 
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Design  Reqtiirements: 

1.  This  module  is  called  after  all  the  analysis  and  gradient  information  has  been  computed  for  a  design 
iteration.  It  is  therefore  the  last  module  within  the  design  iteration  loop. 

Error  Conditions: 

1.  The  module  does  not  have  sufficient  memory  available. 
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Engineering  Application  Module:  DESPUNCH 

Entry  Point:  DESPCH 

Purpose: 

Punchs  out  the  new  Bulk  Data  cards  with  property  values  representing  the  current  design  model.  The 
activation  of  this  module  depends  on  the  punch  input. 

MAPOL  Calling  Sequence: 

CALL  DESPUNCH  (  NITER,  PUNCH,  OLOCALDV  )  ; 

NITER  Current  design  iteration  number  (Integer,  Input) 

PUNCH  Logical  flag  indicating  that  the  user  has  requested  the  new  model  be 

punched  (Logical,  Input) 

OLOCALDV  Relation  of  current  local  design  variable  values  (Input) 

Application  Calling  Sequence: 

None 

Method: 

This  module  works  in  conjunction  with  the  IFP  module  and  the  actcon  module.  IPP  stores  the  design 
invariant  bulk  data  and  the  design  variant  bxilk  data  as  a  series  of  data  base  entities  that  are  read  here. 
The  ACTCON  module  actually  computes  the  current  local  design  variable  values  and  loads  them  in  the 
OLOCALDV  relation.  It  also  sets  the  punch  logical  flag  if  punched  output  has  been  requested  for  the 
current  design  iteration. 

If  the  PUNCH  flag  is  true,  the  data  in  the  OLOCALDV  relation  are  looped  over  and  the  new  property  and/or 
connectivity  bulk  data  entries  are  punched  to  the  ASTROS  punch  file. 

Design  Requirements: 

1.  IFP  must  have  been  called  to  store  the  bulk  data  deck  for  punch  requests. 

2.  ACTCON  must  have  been  called  during  the  current  iteration  to  load  the  OLOCALDV  relation. 

Error  Conditions: 

None 
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Engineering  Application  Module:  DMA 

Entry  Point:  DMA 

Purpose: 


To  assemble  the  direct  and/or  modal  stifbiess,  mass  and/or  damping  matrices  including  extra  point 
degrees  of  freedom  for  transient,  frequency  and  blast  disciplines. 


MAPOL  Calling  Sequence: 

CALL  DMA  (  NITER,  BCID,  ESIZE(BC),  PSIZE(BC),  BGPDT(BC),  USET(BC),  [MAA] , 

[KAA],  [TMN(BC)],  [GSUBO(BC)],  NGDR,  LAMBDA,  [PHIA] ,  [MDD] ,  [BDD] , 
[KDDT],  [KDDF],  [MHH] ,  [BHH] ,  [KHHT] ,  [KHHF] ) ; 


NITER 

BCID 


Design  iteration  number  (Integer,  Input) 

User  defined  boundary  condition  identification  number  (Integer,  Input) 


ESIZE(BC) 

PSIZE(BC} 

BGPDT(BC) 

USET{BC) 

[MAA] 

[KAA] 

[TMM(BC)] 

[GSDBO(BC)] 

NGDR 

LAMBDA 

[PHIA] 

[MDD] 


The  number  of  extra  point  degrees  of  freedom  in  the  boimdary  condition 
(Integer,  Input),  where  BC  represents  the  MAPOL  bomdary  condition 
loop  index  number. 

The  size  of  the  physical  set  for  the  current  boundary  condition. 

(Integer,  Input),  where  BC  represents  the  MAPOL  bovmdary  condition 
loop  index  number. 

Relation  of  basic  grid  point  coordinate  data  (Character,  Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number. 

The  unstructured  entity  defining  structural  sets  (Character,  Input), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number. 

Matrix  entity  containing  the  mass  matrix  in  the  analysis  set  (Input) 

Matrix  entity  containing  the  stiffness  matrix  in  the  analysis  set  (Input) 

Transformation  matrix  for  multipoint  constraints  (Input),  where  BC  repre¬ 
sents  the  MAPOL  boundary  condition  loop  index  number. 

Transformation  matrix  for  reduction  to  the  analysis  set  (Input),  where  BC 
represents  the  MAPOL  boimdary  condition  loop  index  number. 

Denotes  dynamic  reduction  in  the  boxmdary  condition.  (Input,  Integer) 

=0  No  GDR 
=  -1  GDR  is  used 

Relational  entity  containing  the  output  from  the  real  eigenanalysis 
(Input) 

Matrix  of  eigenvectors  from  the  real  eigenanalysis  in  the  analysis  set  (In¬ 
put) 

Direct  dynamic  mass  matrix  (Output) 


[BDD]  Direct  dynamic  damping  matrix  (Output) 

[KDDT]  Direct  transient  stiffiiess  matrix  (Output) 


[KDDF] 


Direct  frequency  stiffness  matrix  (Output) 


[MHH] 


Modal  dynamic  mass  matrix  (Output) 
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[BHH]  Modal  dynamic  damping  matrix  (Output) 

[KHHT]  Modal  transient  stiffiiess  matrix  (Output) 

[KHHF]  Modal  frequency/flutter  stifl&iess  matrix  (Output) 

Application  Calling  Sequence: 

None 

Method: 

The  module  begins  by  retrieving  all  the  CASE  tuples  for  TRANSIENT,  FREQUENCY  or  BLAST  disciplines 
for  the  current  boundary  condition.  If  any  dynamic  matrix  assembly  is  required,  the  BGPDT  data  is  also 
retrieved  and  the  number  of  extra  points  in  the  current  boundary  condition  is  determined  and  the  PSIZE 
variable  set  to  be  the  size  of  the  physical  set.  Continxiing  with  the  module  initiahzation,  the  dmapvc 
submodule  is  called  to  generate  aU  the  partitioning  vectors  for  the  dynamic  degrees  of  freedom  including 
the  extra  points.  If  there  are  extra  points,  the  module  proceeds  to  expand  the  analysis  set  structural 
matrices,  mode  shapes  and  transformation  matrices  to  include  the  extra  point  degrees  of  freedom.  This 
is  done  in  the  DMAEXP  submodule. 

Next,  the  DMAX2  submodule  is  called  to  assemble  any  direct  matrix  input.  These  include  M2PP,  B2PP 
and  K2PP  inputs  as  well  as  transfer  function  data.  The  DMAX2  submodule  forms  the  zeroth,  first  and 
second  order  inputs  in  the  direct  d3niamic  degrees  of  freedom.  The  modal  form  is  obtained  during  the 
actual  dynamic  matrix  assembly. 

The  module  then  proceeds  to  obtain  the  information  needed  to  assemble  the  damping  matrix.  The 
DAMPING  attribute  of  the  CASE  relation  is  checked  and  the  VSDAMP  and  TABDMP  entries  are  searched 
for  a  matching  identification  number.  Logical  flags  are  set  to  indicate  that  damping,  modal  damping 
and/or  direct  damping  are  to  be  used.  If  modal  damping  is  selected,  the  LAMBDA  relation  is  read  to  obtain 
the  natural  firequencies  for  the  computed  modes.  As  a  final  initialization  task,  the  DMA  module  prepares 
the  data  needed  to  generate  the  d-sized  hidden  matrix  entity  icmatrix  used  to  perform  direct  ^ansient 
analysis.  The  ICDATA  information  is  brought  into  open  core  and  the  p-sized  scratch  matrix  to  be  reduced 
to  ICMATRIX  is  created. 

Once  these  initialization  tasks  have  been  completed,  the  loop  to  form  the  direct  and/or  modal  dynamic 
matrices  begins.  The  case  relation  tuples  for  the  dynamic  disciplines  are  searched  sequentially  and  the 
requisite  matrices  formed.  Note  that  the  restrictions  in  the  definition  of  a  boundary  condition  make  it 
such  that  only  one  form  of  each  matrix  is  possible.  The  DMA  module  forms  up  to  eight  matrices:  [MDD] , 
[BDD],  [KDDF],  [MHH] ,  [BHH],  [KDDT] ,  [KHHF],  and  [KHHT]  depending  on  the  requested  disci¬ 
plines  and  discipline  options.  The  INFO  arrays  for  the  matrices  are  used  to  store  flags  denoting  coupled 
or  uncoupled  matrices  and  the  form  of  the  damping  used  in  the  modal  stiffness  and/or  damping  matrices. 
When  all  the  CASE  tuples  have  been  searched  and  the  required  dynamic  matrices  formed,  the  module 
begins  the  cleanup.  The  first  task  is  to  complete  the  generation  of  the  initial  conditions  matrix  by 
reducing  the  scratch  p-sized  matrix  to  the  direct  d3mamic  set.  Following  this  action,  the  other  scratch 
matrices  used  in  the  module  are  destroyed  and  control  returned  to  the  executive. 

Design  Requirements: 

1.  The  PFBULK  module  must  have  been  called  to  perform  the  preprocessing  for  the  initial  conditions, 
transfer  functions,  and  direct  matrix  input. 

Error  Conditions: 

None 
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Engineering  Application  Module:  DYNLOAD 
Entry  Point:  DYNLOD 


Purpose: 

To  assemble  the  direct  and/or  modal  time  and/or  frequency  dependent  loads  including  extra  point 
degrees  of  freedom  for  dynamic  response  disciplines. 

MAFOL  Calling  Sequence: 

CALL  DYNLOAD  (  NITER,  BCID,  GSIZE,  ESIZE(BC),  PSIZE{BC),  SMPLOD,  BGPDT(BC), 

USET(BC),  [TMN(BC)],  [GSUBO(BC)],  NGDR,  [PHIA] ,  [QHJL] ,  [PDT] , 
[PDF] ,  [PTGLOAD] ,  [PTHLOAD] ,  [PFGLOAD] ,  [PFHLOAD]  ) ; 


NITER  Design  iteration  number  (Integer,  Input) 

BCID  User  defined  boimdary  condition  identification  number  (Integer,  Input) 


GSIZE 


Length  of  the  g-set  vector  (Integer,  Input) 


ESIZE(BC) 


PSIZE(BC) 


SMPLOD 


The  number  of  extra  point  degrees  of  freedom  in  the  boundary  condition 
(Integer,  Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number. 

The  size  of  the  physical  set  for  the  current  boundary  condition. 

(Integer,  Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number. 

Unstructured  entity  of  simple  load  vector  information  (Input) 


BGPDT(BC) 

DSET(BC) 

[TMN(BC)] 

[GSTJBO(BC)] 

NGDR 

[PHIA] 


Relation  of  basic  grid  point  coordinate  data  (Input),  where  BC  represents 
the  MAPOL  boundary  condition  loop  index  number. 

The  unstructured  entity  defining  structural  sets  (Input),  where  BC  repre¬ 
sents  the  MAPOL  boimdary  condition  loop  index  number. 

Matrix  for  reducing  MPCs  (Input),  where  BC  represents  the  MAPOL 
boundary  condition  loop  index  number. 

Matrix  for  reducing  omitted  DOF  (Input),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  number. 

Denotes  dynamic  reduction  in  the  boundary  condition. 

=0  No  GDR 
=  -1  GDR  is  used 
(Input,  Integer) 

Natural  modes  matrix  in  the  a-set  (Input) 


[QHJL] 

[PDT] 

[PDF] 

[PTGLOAD] 

[PTHLOAD] 


Aerodynamic  matrix  for  gust  (Input) 

Dynamic  load  vector  for  transient  analysis  (Input) 

Dynamic  load  vector  for  frequency  analysis  (Input) 

Applied  load  matrix  for  the  time  dependent  loads  when  LOAD  print  is  re¬ 
quested  (Character,  Output) 

Applied  load  matrix  for  the  time  dependent  loads  when  MODAL  GUST  print 
is  requested  (Character,  Output) 
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[PFGLOAD]  Applied  load  matrix  for  the  frequency  dependent  loads  when  LOAD  print 

is  requested  (Character,  Output) 

[PFHLOAD]  Applied  load  matrix  for  the  frequency  dependent  loads  when  MODAL  GUST 

print  is  requested  (Character,  Output) 

Application  Calling  Sequence: 

None 

Method: 

The  module  first  interrogates  the  CASE  relation  to  see  whether  any  dynamic  analyses  are  to  be  performed 
for  the  current  boundary  condition.  If  not,  the  module  terminates.  Error  checking  is  performed  to  make 
sure  legal  requests  have  been  made  and  bookkeeping  is  performed  to  set  up  for  matrix  reductions  and 
extra  points.  Call(s)  are  then  made  to  dmapg  to  generate  the  applied  loads  in  the  p-set.  DMAPG  reduces 
these  loads  to  the  d-or  h-set,  depending  on  the  approach.  Separate  routines  generate  loads  in  the 
frequency  and  time  domains. 

Design  Requirements: 

1.  Follows  computation  of  quantities  in  the  a-set.  If  the  MODAL  approach  is  being  used,  the  natural  mode 
shapes  must  be  computed. 

Error  Conditions: 

1.  No  more  than  one  frequency  and/or  transient  load  is  allowed  per  boundary  condition. 
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Engineering  Application  Module:  DYNRSP 
Entry  Point:  DYNRSP 


Purpose: 

To  compute  the  direct  or  modal  displacements,  velocities  and  accelerations  for  transient  and  frequency 
analyses. 


MAPOL  Calling  Sequence: 

CALL  DTORSP  (  BCID,  ESIZE(BC),  [MDD] ,  [BDD] ,  [KDDT] ,  [KDDF] ,  [MHH] ,  [BHH] , 
[KHHT] ,  [KHHF] ,  [PDT] ,  [PDF] ,  [QHHL] ,  [DTRANA]  ,  [UFREQA]  , 
[OTRANI]/  [UFREQI],  [UTRANE] ,  [UFREQE]  ); 


BCID 

ESIZE(BC) 

[MDD] 

[BDD] 

[KDDT] 

[KDDF] 

[MHH] 

[BHH] 

[KHHT] 

[KHHF] 

[PDT] 

[PDF] 

[QHHL] 

[UTRANA] 

[UFREQA] 

[UTRANI] 

[UFREQI] 

[UTRANE] 

[UFREQE] 


User  defined  boundary  condition  identification  number  (Integer,  Input) 

The  number  of  extra  point  degrees  of  freedom  in  the  boundary  condition 
(Integer,  Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number. 

Mass  matrix  in  the  d-set  (Input) 

Damping  matrix  in  the  d-set  (Input) 

Stiffiaess  matrix  in  the  d-set  for  transient  analyses  (Input) 

Stiffness  matrix  in  the  d-set  for  frequency  analyses  (Input) 

Modal  mass  matrix  (Input) 

Modal  damping  matrix  (Input) 

Modal  stff&iess  matrix  for  transient  analyses  (Input) 

Modal  stiffiiess  matrix  for  frequency  analyses  (Input) 

Matrix  of  apphed  loads  for  transient  analysis  (Input) 

Matrix  of  applied  loads  for  frequency  analysis  (Input) 

Generalized  aerodynamic  forces  for  gust  analyses  (Input) 

Transient  response  vectors  in  the  a-set  (Output) 

Frequency  response  vectors  in  the  a-set  (Output) 

Transient  response  vectors  in  the  i-set  (Output) 

Frequency  response  vectors  in  the  i-set  (Output) 

Transient  response  vectors  in  the  e-set  (Output) 

Frequency  response  vectors  in  the  e-set  (Output) 


Application  Calling  Sequence: 


None 


Method: 


The  module  first  interrogates  the  case  relation  to  see  whether  any  dynamic  analyses  are  to  be  performed 
for  the  current  boundary  condition.  If  not,  the  module  terminates.  Bookkeeping  is  performed  to  set  up 
for  any  gust  analyses  and  to  process  extra  points.  A  loop  on  the  number  of  cases  with  dynamic  response 
requirements  for  the  current  boundary  condition  is  then  made.  Time  or  frequency  points  at  which  the 
response  is  required  are  established  and  the  required  analyses  are  performed.  Separate  subroutines 
control  the  performance  of  requested  analyses: 


ROUTINES 

PURPOSE 

TRUNCS/D 

Uncoupled  transient  analysis 

TRCOUP 

Coupled  transient  analysis 

FRUNCS/D 

Uncoupled  frequency  analysis 

1  FRCOUP 

Coupled  frequency  analysis 

1  FRGUST 

Frequency  response  with  ffust 

These  routines  fill  output  vectors  with  response  quantities  (displacement,  velocity  and  acceleration).  If 
there  are  extra  points,  a  partitioning  operation  is  performed  to  segregate  extra  point  data  into  separate 
matrix  entities. 

Design  Requirements: 

1.  Modules  DMA  and  DYNLOAD  prepare  matrix  quantities  that  are  required  for  this  module.  If  a  gust 
analysis  is  being  performed,  module  QHHLGEN  must  have  been  processed  as  well. 

Error  Conditions: 

None 
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Engineering  Application  Module:  ebkleval 

Entry  Point:  EBKEVA 

Purpose: 


Evaluates  the  current  values  of  the  Euler  buckling  constraints. 

MAPOL  Calling  Sequence: 

CALL  EBKLEVAL  (  BCID,  NITER,  NDV,  GLBDES,  LOCLVAR,  [PTRANS] ,  CONST, 
FDSTEP,  OEULBUCK  ) ; 


BCID 

NITER 

NDV 

GLBDES 

LOCLVAR 

[PTRANS] 

CONST 

FDSTEP 

OEULBUCK 


User  defined  boundary  condition  identification  number  (Integer,  Input) 

Design  iteration  number  (Integer, Input) 

Number  of  design  variables  (Integer,Input) 

Relation  of  global  design  variables  (Character,Input) 

Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Character,Input) 

The  design  variable  linking  matrix  (Character, Input) 

Relation  of  constraint  values  (Character, Output) 

Relative  design  variable  increment  for  finite  difference  computation 
(Real,Input) 

Relation  containing  Euler  buckling  constraint  output  (Character,Output) 


Application  Calling  Sequence: 

None 

Method: 

This  module  first  checks  if  any  DCONBKE  Bulk  Data  entries  are  referenced  by  any  STATICS  anchor 
SAERO  disciplines  for  the  current  boundary  condition  to  determine  if  there  any  Euler  buckling 
constraints  have  been  apphed.  If  any  are  foimd,  the  BAR  and/or  ROD  element  data  are  obtained  firom 
relation  BEAMEST  and/or  RODEST,  and  the  element  force  data  are  obtained  from  relation  EOBAR  and/or 
EOROD,  and  the  Euler  buckling  constraint  values  are  evaluated  and  stored  into  relation  CONST.  The 
constraint  sensitivity  data  are  also  prepared  in  this  module. 

Design  Requirements: 

This  module  needs  element  output  relation  from  module  edr,  therefore  should  only  be  called  after 
module  edr. 

Error  Conditions: 

1.  Euler  buckling  control  elements  with  improper  boundary  condition  type  are  flagged. 

2.  Euler  buckling  control  elements  with  improper  moment  of  inertia  parameters  are  flagged. 
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Engineering  Application  Module :  EBKLSENS 


Entry  Point:  EBKSNS 


Purpose: 

Evaluates  the  Euler  buckling  constraint  sensitivity. 
MAPOL  Calling  Sequence: 


CALL  EBKLSENS  (  BCID, 
BCID 
NITER 
NDV 
CONST 
DESLINK 
GLBDES 
[AMAT] 


NITER,  NDV,  CONST,  DESLINK,  GLBDES,  [AMAT]  ); 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

Design  iteration  number  (Integer, Input) 

Number  of  design  variables  (Integer, Input) 

Relation  of  constraint  values  (Character, Input) 

Relation  of  design  variable  linking  information  (Character,Input) 

Relation  of  global  design  variables  (Character,Input) 

Matrix  containing  the  sensitivity  of  the  constraints  to  changes  in  the  de¬ 
sign  variable  (Character, Output) 


Application  Calling  Sequence: 


None 


Method: 


This  module  first  checks  if  there  any  active  Euler  buckling  constraints  for  the  current  boundary 
condition.  If  so,  the  constraint  sensitivity  data  are  retrieved  from  relation  CONST.  Then  the  design 
variable  identification  list  is  then  obtained  from  relation  GLBDES,  and  the  design  variable  linking  data 
are  obtained  from  relation  DESLINK.  For  each  active  Euler  buckling  constraint,  the  sensitivity  to  the 
design  variables  is  computed  and  stored  into  matrix  [AMAT] . 


Design  Requirements: 
None 


Error  Conditions: 
None 
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Engineering  Application  Module:  EDR 

Entry  Point:  EDRDRV 

Purpose: 

To  compute  the  stresses,  strains,  grid  point  forces  and  strain  energies  for  elements  selected  for  output 
for  the  particular  boundary  condition. 

MAPOL  Calling  Sequence: 

CALL  EDR  (  BCID,  NITER,  NDV,  GSIZE,  EOSDMMRY,  EODISC,  GLBDES, 

LOCLVAR,  [PTRANS],  lUG(BC)],  [UAG{BC)],  [BLUG] ,  [UTRANG] , 


[DFREQG]  , 

[PHIG(BC)],  [PHIGB(BC)]  ); 

BCID 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

NITER 

Iteration  number  for  the  current  design  iteration  (Integer,  Input) 

NDV 

The  number  of  global  design  variables  (Integer,  Input) 

GSIZE 

The  size  of  the  structural  set  (Integer,  Input) 

EOSDMMRY 

Relation  containing  the  summary  of  elements,  design  iterations  and 
boundary  conditions  for  which  output  is  desired  (Input) 

EODISC 

Unstructured  entity  referred  to  by  EOSDMMRY  containing  the  disciplines 
for  which  output  is  required  for  each  element/iteration/boundaiy  condi¬ 
tion  (Input) 

GLBDES 

Relation  of  global  design  variables  (Character,  Input) 

LOCLVAR 

Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Character,  Input) 

[PTRANS] 

The  design  variable  linking  matrix  (Character,  Input) 

[UG{BC)] 

Matrix  of  global  displacements  from  STATICS  analyses  (Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number. 

[nAG(BC)] 

Matrix  of  global  displacements  from  SAERO  analyses  (Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number. 

[BLUG] 

Matrix  of  global  displacements/velocities/accelerations  for  BLAST  re¬ 
sponse  analyses  (Input) 

[XITRANG] 

Matrix  of  global  displacements/velocities/accelerations  for  TRANSIENT  re¬ 
sponse  analyses  (Input) 

[UFREQG] 

Matrix  of  global  displacements/velocities/accelerations  for  frequency  re¬ 
sponse  analyses  (Input) 

[PHIG(BC)] 

Matrix  of  global  eigenvectors  from  real  eigenanalysis  for  MODES  analyses 
(Input),  where  BC  represents  the  MAPOL  boxmdary  condition  loop  index 
number. 

[PHIGB(BC)] 

Matrix  of  global  eigenvectors  for  buckling  analyses  (Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number. 
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Application  Calling  Sequence: 

None 

Method: 

The  EOStJMMRY  relation  is  opened  and  read  for  the  current  boundary  condition.  If  any  element  output 
requests  exist,  processing  continues  by  loading  the  input  matrices  associated  with  the  discipline 
dependent  displacement  fields  into  an  character  array  such  that  the  order  in  which  disciplines  are 
processed  correspond  to  the  order  of  the  matrices.  Following  this,  there  is  a  section  of  code  set  aside  for 
discipline  dependent  processing.  Currently,  two  tasks  are  performed: 

(1)  The  number  of  mode  shapes  computed  in  the  real  eigenanalysis  (if  one  was  performed)  is  determined 
by  opening  the  PHIG  matrix;  and  (2)  any  thermal  load  set  ID’s  in  the  case  relation  are  replaced  by  the 
record  number  in  gridtemp  that  corresponds  to  the  applied  load  case. 

The  initialization  tasks  continue  with  a  call  to  the  PRELDV  utility  to  set  up  for  computation  of  the  local 
design  variables  associated  with  designed  elements.  The  transformation  matrices  and  material  proper¬ 
ties  are  also  prepared  for  fast  retrieval  by  the  element  routines.  The  gppdata  relation  is  opened  for 
output  and  the  EODISC  data  is  read  into  memory.  At  this  point,  the  EODISC  record  number  in  the 
EOSXElMRY  data  is  replaced  by  the  open  core  pointer  where  the  record  begins  in  memory.  With  the 
mitiahzation  complete,  the  edr  module  proceeds  to  compute  the  desired  element  response  quantities 
for  all  the  "subcases"  (considered  by  edr  to  be  represented  by  a  single  displacement  vector)  for  any  or 
aU  disciplines  that  have  been  analyzed  in  the  current  boimdary  condition.  The  computation  occurs  in 
the  following  three  steps: 

(1)  Determine  the  set  of  disciplines  and  subcases  for  which  any  element  response  quantities  are 
needed 

(2)  Read  into  open  core  as  many  displacement  vectors  (real  and/or  complex)  as  wiU  fit 

(3)  Call  element  dependent  routines  to  compute  the  stress,  strain,  strain  energy,  forces  and  grid 
point  forces  for  each  displacement  vector 

lb  perform  step  (1),  the  eosummry  data  is  read  for  each  discipline  and  the  corresponding  EODISC  data 
is  used  to  form  a  unique  list  of  subcases  for  each  discipline  in  the  current  boimdary  condition.  A  list  of 
the  form: 

NDISC, (DISC  TYPE (I) ,NSUBCASE, SUBCASE  ID ( J) , J=l, NSUBCASE) , I=1,1IDISC) 

These  data  are  sorted  by  discipline  type  in  the  order  defined  in  the  /edrdis/  common  block  and  by  the 
subcase  "identification  numbers"  within  each  discipline.  The  subcase  ID’s  refer  to  the  column  number 
in  the  displacement  matrix  for  the  discipline.  For  statics  and  modes,  these  numbers  are  incremented 
by  one  for  each  new  load  condition  or  eigenvector  while  transient,  firequency  and  blast  results  use  an 
increment  of  three  to  accommodate  the  velocity  and  accelerations  that  are  stored  in  the  same  matrix. 
After  this  in-core  hst  has  been  formed,  it  is  read  to  determine  which  displacement  vectors  are  to  be 
brought  into  open  core.  The  module  determines  the  amount  of  remaining  memory  and  brings  as  many 
displacement  vectors  into  memory  as  possible.  The  terms  are  converted  to  single  precision  at  this  point. 
Once  all  the  displacements  are  in  memory,  or  memory  is  full,  the  element  dependent  routines  are  called. 
Within  each  element  dependent  routine,  the  geometrical  portion  of  the  element  processing  is  performed 
once  followed  by  a  loop  over  all  incore  displacements  to  compute  the  element  response  quantities.  For 
each  displacement  set,  aU  the  element  response  quantities  including  grid  point  forces,  stresses,  strains, 
strain  energies  and  element  forces  are  computed  and  stored  on  the  EOxxxx  element  response  quantity 
relations.  Note  that  the  exact  quantities  requested  by  the  user  are  not  used  at  this  point,  but  will  only 
be  used  to  determine  which  data  to  print.  Once  aU  the  elements  have  been  processed,  the  module  loops 
back  for  any  remaining  displacement  vectors  and,  when  all  of  these  are  processed,  terminates. 
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Design  Requirements: 

1.  The  PFBULK  processing  of  the  element  output  requests  must  have  been  completed  and  be  compatible 
with  the  data  currently  resident  in  the  CASE  relation. 

2.  The  module  may  be  called  when  no  element  output  requests  exist  in  the  Solution  Control. 

Error  Conditions: 

None 
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Engineering  Application  Module:  EMAl 
Entry  Point:  EMAl 


Purpose: 

To  assemble  the  linearly  designed  element  stiffness  and  mass  matrices  (stored  in  the  kelm  and  melm 
entities)  into  the  linear  design  sensitivity  matrices  DKVIO  and  DMVIO. 

MAPOL  Calling  Sequence: 

CALL  EMAl  (  NDV,  CSTM,  GEMEL,  DVCT,  KELM,  MELM,  GMKCTO,  DKVIO,  GMMCTO, 

DMVIO,  DWGHl  ); 

NDV  Number  of  design  variables  (Integer,  Input) 

CSTM  Relation  containing  the  coordinate  transformation  matrices  for  all  exter¬ 

nal  coordinate  systems  (Character, Input) 

GEMEL  Unstructured  entity  containing  information  from  GENEL  Bulk  Data  en¬ 

tries  (Character,Input) 

DVCT  Relation  containing  the  data  required  for  the  assembly  of  the  linear  de¬ 

sign  sensitivity  matrices  (Character,  Input) 

KELM  Unstructured  entity  containing  the  linear  design  element  stif&iess  matrix 

partitions  (Character,  Input) 

MELM  Unstructured  entity  containing  the  linear  design  element  mass  matrix 

partitions  (Character,  Input) 

GMKCTO  Relation  containing  connectivity  data  for  the  DKVIO  sensitivity  matrix 

(Output) 

DKVIO  Unstructured  entity  containing  the  linear  design  stiffliess  sensitivity  ma¬ 

trix  in  a  highly  compressed  format  (Output) 

GMMCTO  Relation  containing  connectivity  data  for  the  DMVIO  sensitivity  matrix 

(Output) 

DMVIO  Unstructured  entity  containing  the  linear  design  mass  sensitivity  matrix 

in  a  highly  compressed  format  (Output) 

DWGHl  Unstructured  entity  containing  the  linear  (invariant)  part  of  the  sensitiv¬ 

ity  of  weight  to  the  design  variables  (Output) 

Application  Calling  Sequence: 

None 

Method: 

This  module  deals  with  linearly  designed  stifBiess  and  mass  matrices,  while  module  nlemaI  deals  with 
nonlinear  design  stif&iess  and  mass  matrices.  The  module  is  executed  in  two  passes;  once  for  linear 
design  stif&iess  matrices  and  a  second  time  for  linear  design  mass  matrices.  In  the  first  pass,  DVCT 
information  is  read  into  core  one  record  at  a  time.  The  algorithm  is  structured  to  maximize  the  amount 
of  processing  done  on  a  given  design  sensitivity  matrix  (typically  all  of  it)  in  core.  Spill  logic  is  in  place 
if  a  matrix  cannot  be  completely  held  in  core.  For  the  assembly,  subroutine  KQCORl  performs  bookkeep¬ 
ing  tasks  to  expedite  the  assembly  and  to  determine  whether  spiU  will  be  necessary.  Subroutine  ASSEMl 
retrieves  kelm  information,  performs  the  actual  assembly  operations  and  places  the  results  into  the 
GMKCTO  and  DKVIO  entities.  When  the  DVCT  data  have  been  exhausted  a  check  is  made  as  to  whether 
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mass  assembly  is  required.  If  a  discipline  which  requires  a  mass  matrix  is  included  in  the  solution 
control,  the  mass  terms  are  assembled  in  the  second  pass.  If  there  are  optimize  boimdary  conditions, 
t.big  module  calculates  the  linear  portion  of  sensitivity  of  the  objective  to  the  design  variables  regardless 
of  whether  the  dmviO  matrices  are  required.  If  no  mass  information  is  required,  control  is  returned  to 
the  executive  and  the  second  pass  through  the  module  is  not  made.  For  the  second  pass,  melm  data  are 
used.  The  structure  of  the  assembly  operation  is  otherwise  much  the  same  and  GMMCTO  and  DMVIO  data 
are  computed  and  stored. 

Design  Requirements: 

1.  This  assembly  operation  follows  the  makest  and  emg  modules. 

2.  Since  gravity  loads  require  DMVIO  data,  it  is  necessary  to  perform  EMAl  prior  to  calling  lodgen.  emaI 
must  always  he  called  before  EMA2. 

Error  Conditions: 

None 
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Engineering  Application  Module:  EMA2 

Entry  Point:  EMA2 

Purpose: 

To  assemble  the  element  stif&ess  and  mass  matrix  partitions  (stored  in  the  DKVIG  and  DMVIG  entities) 
into  the  global  stif&iess  and  mass  matrices  for  the  current  design  iteration. 

MAPOL  Calling  Sequence: 

CALL  EMA2  (  NITER,  NDV,  GSIZEB,  GLBDES,  GNKCTG,  DKVIG,  [KIGG] ,  GNMCTG, 

DMVIG,  [MIGG]  ) ; 


NITER 

Design  iteration  number  (Integer,  Input) 

NDV 

The  number  of  design  variables  (Integer,  Input) 

GSIZEB 

Length  of  the  g-set  vectors  (Integer,  Input) 

GLBDES 

Relation  of  global  design  variables  (Character,  Input) 

GMKCTG 

Relation  containing  connectivity  data  for  the  DKViG  sensitivity  matrix 
(Character,  Input) 

DKVIG 

Unstructured  entity  containing  the  stiffiiess  matrix  partitions  in  a  highly 
compressed  format  (Character,  Input) 

[KIGG] 

Assembled  stifihess  matrix  in  the  g-set  (Output) 

GMMCTG 

Relation  containing  connectivity  data  for  the  DMVIG  sensitivity  matrix 
(Character,  Input) 

DMVIG 

Unstructured  entity  containing  the  mass  matrix  partitions  in  a  highly 
compressed  format  (Character,  Input) 

[MIGG] 

Assembled  mass  matrix  in  the  g-set  (Output) 

Application  Calling  Sequence: 

None 

Method: 

The  structure  of  this  module  resembles  that  of  EMAl  and  is  also  executed  in  two  passes.  In  the  first  pass, 
GMKCTG  information  is  read  into  core  one  record  at  a  time.  The  algorithm  is  structured  to  maximize  the 
number  of  columns  of  the  global  stifihess  matrix  that  are  assembled  at  one  time.  Spill  logic  is  in  place 
if  aU  the  columns  cannot  be  assembled  at  once.  For  the  assembly,  subroutine  RQCOR2  performs 
bookkeeping  tasks  to  expedite  the  assembly  and  to  determine  whether  spill  will  be  necessary.  Subroutine 
ASSEM2  retrieves  the  DKVIG  information,  performs  the  assembly  in  core  using  the  current  values  of  the 
design  variables,  and  stores  the  data  into  KGG.  When  the  GMKCTG  data  have  been  exhausted  a  check  is 
performed  as  to  whether  mass  assembly  is  required.  Flags  were  written  by  nlemai  on  the  INFO  array 
of  the  DKVIG  entity  to  indicate  whether  mass  assembly  is  required.  If  no  mass  information  is  required, 
control  is  returned  to  the  executive;  if  it  is,  the  second  pass  through  the  module  takes  place.  For  the 
second  pass,  DMVIG  and  GMMCTG  data  are  used  to  generate  the  mgg  matrix.  The  structure  of  the  assembly 
operation  is  otherwise  much  the  same  and  the  MGG  matrix  is  computed  and  stored. 
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Design  Requirements: 

1.  For  OPTIMIZE  boundary  conditions,  EMA2  precedes  the  optimization  boundary  condition  loop.  For 
ANAIjYZE  boimdary  conditions,  the  module  immediately  precedes  the  loop  on  analyze  boundary  condi¬ 
tions  and  the  NITER  argument  is  not  required.  In  both  cases,  EMA2  must  always  follow  nlemaI. 

2.  niter  must  be  nonzero  for  optimization  boundary  conditions. 

Error  Conditions: 

None 


Engineering  Application  Module;  EMG 

Entry  Point:  EMG 

Purpose: 

Tb  compute  the  linear  design  variable  part  of  element  stifbiess,  mass,  thermal  load  and  stress 
component  sensitivities  for  all  structural  elements. 

MAPOL  Calling  Sequence: 

CALL  EMG  (  NDV,  GSXZEB,  K6ROT,  GLBDES,  LOCLVAR,  [PTRANS] ,  DESLIMK,  [SMAT] , 
SMATCOL,  DVCT,  DVSIZE,  KELM,  MELM,TELM,  TREE  ); 


NDV 

The  number  of  design  variables  (Integer,  Input) 

6SIZEB 

The  size  of  the  structural  set  (Integer,  Input) 

K6ROT 

Stif&iess  value  for  plate  element  "drilling"  degrees  of  freedom  (Real, Input) 

GLBDES 

Relation  of  global  design  variables  (Character,  Input) 

LOCLVAR 

Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Input) 

[PTRANS] 

The  design  variable  linking  matrix  (Input) 

DESLXNK 

Relation  of  design  variable  connectivity  from  MAKEST  module  containing 
one  record  for  each  global  design  variable  connected  to  each  local  vari¬ 
able.  (Character,  Input) 

[SMAT] 

Matrix  entity  containing  the  linear  portion  of  sensitivity  of  the  stress 
and  strain  components  to  the  global  displacements  (Character,  Output) 

SMATCOL 

Relation  containing  matrix  [SMAT]  column  information 
(Character, Output) 

DVCT 

Relation  containing  the  data  required  for  the  assembly  of  the  linear  de¬ 
sign  sensitivity  matrices  (Character,  Output) 

DVSIZE 

Unstructured  entity  containing  memory  allocation  information  on  the 
DVCT  relation  (Character,  Output) 

KELM 

Unstructured  entity  containing  the  linear  design  element  stif&iess  matrix 
partitions  (Character,  Output) 

MELM 

Unstructured  entity  containing  the  linear  design  element  mass  matrix 
pEirtitions  (Character,  Output) 

TELM 

Unstructured  entity  containing  the  linear  design  element  thermal  load 
partitions  (Character,  Output) 

TREE 

Unstructured  entity  containing  the  linear  design  element  reference  tem¬ 
peratures  for  thermal  loads  (Character,  Output) 

Application  Calling  Sequence: 
None 


140 


Method: 


The  EMG  module  performs  the  linear  design  variable  part  of  the  second  phase  of  the  structural  element 
preface  operations  with  the  makest  module  performing  the  first  phase.  The  nlemg  module  performs 
the  nonlinear  design  variable  part  of  the  second  phase.  As  a  result,  modules  EMG  and  MAKEST  are  very 
closely  related.  The  first  action  of  the  EMG  module  is  to  determine  if  design  variables  and/or  thermal 
loads  are  defined  in  the  bulk  data.  If  they  are,  the  special  actions  for  design  variable  linking  and  thermal 
stress  corrections  are  taken  in  the  element  dependent  routines.  The  PREMAT  utility  to  set  up  the  material 
property  data  also  returns  the  SCON  logical  flag  to  denote  that  there  are  stress  constraints  defined  in 
the  bulk  data.  The  initialization  of  the  module  continues  with  the  retrieval  of  the  mform  data  to  select 
lumped  or  coupled  mass  matrices  in  the  elements  that  support  both  forms.  The  default  is  Imnped 
although  any  mform/COXJPLED  (even  if  mform/lomped  also  exists  )  will  cause  the  coupled  form  to  be 
used.  If  thermal  loads  exist,  the  module  prepares  the  tree  entity  to  be  written  by  the  element  dependent 
routines.  The  GLBDES  relation  is  opened  and  the  design  variable  identification  numbers  are  read  into 
memory.  Finally,  the  DVCT  entity  is  opened  and  flushed  and  memory  is  retrieved  to  be  used  in  the  dvctld 
submodule  to  load  the  dvct  relation.  The  module  then  calls  each  element  dependent  routine  in  turn. 
The  order  in  which  these  submodules  are  called  is  very  important  in  that  it  provides  an  implidt  order 
for  the  MAKEST,  EMG,  SCEVAL,  EDR  and  OFP  modules.  That  order  is  alphabetical  by  connectivity  bulk 
data  entry  and  results  in  the  following  sequence: 

(1)  Bar  elements 

(2)  Scalar  spring  elements 

(3)  Linear  isoparametric  hexahedral  elements 

(4)  Quadratic  isoparametric  hexahedral  elements 

(5)  Cubic  isoparametric  hexahedral  elements 

(6)  Scalar  mass  elements 

(7)  General  concentrated  mass  elements 

(8)  Rigid  body  form  of  the  concentrated  mass  elements 

(9)  Isoparametric  quadrilateral  membrane  elements 

(10)  Quadrilateral  bending  plate  elements 

(11)  Rod  elements 

(12)  Shear  panels 

(13)  Triangular  bending  plate  elements 

(14)  Triangular  membrane  elements 

Within  each  element  dependent  routine,  the  sbexEST  relation  for  the  element  is  opened  and  read  one 
tuple  at  a  time.  If  the  EST  relation  indicates  that  the  element  is  designed,  the  DESniMK  data  is  used  to 
write  one  set  of  tuples  to  the  dvct  relation  for  each  unique  design  variable  linked  to  the  element.  The 
set  of  tuples  consists  of  one  row  for  each  node  to  which  the  element  is  connected.  If  the  element  is  not 
designed,  a  single  set  of  tuples  is  written  connected  to  the  "zeroth"  (implicit)  design  variable.  The  element 
dependent  geometry  processor  is  then  called  to  generate  the  KEUl,  melm  and  TELM  entries  for  the 
element.  Note  the  kelm  and  TELM  entities  related  to  nonlinear  design  stiffiiesses  are  empty,  and  MELM 
entries  related  to  nonlinear  design  mass  are  empty.  These  data  must  be  generated  before  the  next  call 
to  DVCTLD  since  the  dvct  forms  the  directory  to  aU  three  of  these  entities.  Once  all  the  elements  are 
processed  within  the  current  element  dependent  routine,  the  TREE  entity  is  appended  with  the  vector 
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of  reference  temperatures  for  the  current  set  of  elements.  Again,  the  order  of  these  reference  tempera¬ 
tures  are  determined  by  the  sequence  listed  above  and  is  assumed  to  hold  in  other  modules.  When  all 
the  element  dependent  drivers  have  been  called  by  the  EMG  module  driver,  clean  up  operations  begin. 
The  entities  that  have  been  open  for  writing  by  the  element  routines  are  closed,  the  remaining  in-core 
DVCT  tuples  are  written  to  the  data  base  and  the  DVCT  relation  is  sorted.  If  there  are  design  variables, 
the  DVCT  is  sorted  on  the  DVID  attribute  and,  within  each  unique  DVID,  by  KSIL.  If  there  are  no  design 
variables  (all  DViD’s  are  zero),  the  DVCT  is  sorted  only  on  KSIL.  Finally,  if  stress  or  strain  constraints 
were  defined  in  the  bulk  data  stream,  the  smat  matrix  of  constraint  sensitivities  to  the  displacements 
is  closed,  smat  was  opened  by  the  premat  module  when  the  SCON  constraint  flag  was  set. 

Design  Requirements: 

1.  The  MAKEST  module  must  have  been  called  prior  to  the  emg  module. 

Error  Conditions: 

1.  Illegal  element  geometries  and  nonexistent  material  properties  are  flagged. 
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Engineering  Application  Module:  FCEVAL 
Entry  Point:  FCEVAL 

Purpose: 

Tb  evaluate  the  current  value  of  all  frequency  constraints. 

MAPOL  Calling  Sequence: 

CALL  FCEVAL  (  NITER, 

NITER 
BCID 
LAMBDA 

CONST 

Application  Calling  Sequence: 

None 
Method: 

The  FCEVAL  module  first  determines  if  any  frequency  constraints  are  applied  to  the  modal  analysis  in 
the  current  boundary  condition.  If  any  constraints  are  applied  to  the  modal  analysis,  the  module 
proceeds  to  open  the  DCONFRQ  relation  to  obtain  the  apphed  constraints  and  the  LAMBDA  relation  to 
obtain  the  computed  frequencies.  The  final  initialization  task  is  to  open  the  CONST  relation  to  store  the 
computed  frequency  constraints.  The  actual  computation  involves  looping  through  the  DCONFRQ  relation 
for  the  current  frequency  constraint  set  and  conditioning  the  XiAMBDA  relation  to  retrieve  the  results  for 
the  modes  that  are  constrained.  Having  retrieved  the  mode  number  and  the  computed  modal  frequency 
from  LAMBDA,  the  apphed  upper  or  lower  bound  constraint  is  computed  and  stored  on  the  CONST  relation. 
Finally,  the  frequency  responses  which  are  required  by  any  user  function  constraints  are  also  computed. 

Design  Requirements: 

1,  The  FCEVAL  module  assumes  that  the  current  boxmdary  condition  is  an  optimization  boimdary 
condition. 

Error  Conditions: 

1.  The  frequency  constraint  set  referenced  by  Solution  Control  does  not  exist  in  the  DCONFRQ  relation. 

2.  The  frequency  or  eigenvector  for  the  constrained  mode  was  not  extracted  in  the  real  eigenanalysis. 

3.  The  constrained  mode  is  a  rigid  body  mode  (zero  frequency)  and  therefore  cannot  be  constrained. 


BCID,  LAMBDA,  CONST  ); 

Design  iteration  number  (Integer,  Input) 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

Relational  entity  containing  the  output  from  the  real  eigenanalysis 
(Input) 

Relation  of  design  constraint  values  (Character,  Output) 
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Engineering  Application  Module:  FLUTDMA 
Entry  Point:  FLTDMA 


Purpose: 

Assembles  the  dynamic  matrices  for  the  flutter  disciplines. 

MAPOL  Calling  Sequence: 

CALL  FLUTDMA  {  NITER,  BCID,  SUB,  ESIZE(BC),  PSIZE(BC),  BGPDT{BC),  DSET(BC), 
[MAA],  [KAA],  [TMN(BC)],  [6SUB0(BC)],  NGDR,  LAMBDA,  [PHIA] , 
[MHHFL(BC,SUB)],  [BHHFL{BC, SUB) ] ,  [KHHFL (BC, SUB) ]  ) ; 


NITER 

BCID 

SUB 

ESIZE(BC) 

PSIZE(BC) 

BGPDT(BC) 

USET(BC) 

[MAA] 

[KAA] 

[TMN(BC)] 

[GSUBO(BC)] 

NGDR 

LAMBDA 

[PHIA] 


Design  iteration  number  (Integer,  Input) 

User  defined  boimdary  condition  identification  number  (Integer,  Input) 
Flutter  subceise  number  (Integer,  Input) 

Number  of  extra  points  for  the  current  bmmdary  condition  (Integer,  In¬ 
put),  where  BC  represents  the  MAPOL  boimdaty  condition  loop  index 
number 

Number  of  physical  degrees  of  fi'eedom  in  the  current  boimdary  condi¬ 
tions  (GSIZE+ESIZE)  (Integer,  Input),  where  BC  represents  the  MAPOL 
boundary  condition  loop  index  nximber 

Current  boundary  condition’s  relation  of  basic  grid  point  data  (expanded 
to  include  extra  points  and  any  GDR  scalar  points)  (Input),  where  BC  rep¬ 
resents  the  MAPOL  boundary  condition  loop  index  number 

Current  boundary  condition’s  xmstructured  entity  of  set  definition  masks 
(expanded  to  include  extra  points  and  any  GDR  scalar  points)  (Input), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number 

Mass  matrix  in  the  analysis  set  (Input) 

Stif&iess  matrix  in  the  analysis  set  (Input) 

Multipoint  constraint  transformation  matrix  for  the  current  boimdary 
condition  (Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

Static  condensation  or  GDR  reduction  matrix  for  the  current  boimdary  con¬ 
dition  (Input),  where  BC  represents  the  MAPOL  boundary  condition  loop 
index  number 

Denotes  dynamic  reduction  in  the  boundary  condition  (Input,  Integer) 

=  0  No  GDR 
=  -1  GDR  is  used 

Relation  of  normal  mode  eigenvalues  output  fi-om  the  REIG  module 
(Input) 

Matrix  of  normal  mode  eigenvectors  m  the  analysis  set  output  from  REiG 
(Input) 


[MHHFL(BC,SDB) ] 


[BHHFL(BC,SUB) ] 


[KHHFL(BC,SUB) ] 


Generalized  mass  matrix  for  the  current  flutter  subcase  in  the  h-set 
(normal  modes+extra  points)  including  any  transfer  functions  and  M2PP 
input  (Output),  where  BC  represents  the  MAPOL  boundaiy  condition  loop 
index  number 

Generahzed  damping  matrix  for  the  current  flutter  subcase  in  the  h-set 
(normal  modes+extra  points)  including  any  transfer  functions,  B2PP  in¬ 
put  anti  VSDAMP  input  (Output),  where  BC  represents  the  MAPOL  bound¬ 
ary  condition  loop  index  number 

Generalized  stiffness  matrix  for  the  current  flutter  subcase  in  the  h-set 
(normal  modes+extra  points)  including  any  transfer  functions  K2PP  input 
and  VSDAMP  input  (Output),  where  BC  represents  the  MAPOL  boimdary 
condition  loop  index  nmnber 


Application  Calling  Sequence: 
None 


Method: 

CASE  is  checked  to  see  if  any  flutter  subcases  exist  for  the  current  boundary  condition.  If  not,  control 
is  returned  to  the  MAPOL  sequence.  If  flutter  subcases  exist,  the  dynamic  matrix  descriptions  for 
the  current  subcase  (as  indicated  by  the  SUB  input)  are  brought  into  memory  from  CASE.  Then  the  bgpdt 
data  are  read  into  memory  and  the  DMAPVC  submodule  is  called  to  generate  partitioning  matrices  to 
expand  the  input  matrices  to  the  p-set  from  the  g-set  and  to  strip  off  the  GDR  extra  points  where 
appropriate.  If  extra  points  are  defined,  the  MAA,  KAA,  PHIA,  TMN  and  GSUBO  are  then  expanded  to 
include  the  d-set  extra  point  DOF. 

Following  the  expansion  of  the  input  matrices,  the  direct  matrix  input  M2PP,  B2PP  and  K2PP  are 
assembled  and  reduced  to  the  direct  d-set  DOF  in  the  submodule  dmax2.  Modal  transformations  occur 
later  in  the  module.  Following  the  x2PP  formation,  the  VSDAMP  data  are  set  depending  on  the  DAMPING 
selection  for  the  flxjtter  subcase.  Finally,  the  lambda  relation  is  read  into  memory  to  have  the  modal 
frequencies  available  for  modal  damping  computations. 

Following  all  these  preparations,  the  utility  submodules  dmamhh,  dmabbh  and  dmakhh  are  used  to 
assemble  the  modal  mass,  damping  and  stiffness  matrices  accoimting  for  all  the  dynamic  matrix  options. 
Control  is  then  returned  to  the  MAPOL  program. 


Design  Requirements: 

1.  The  FLUTDMA  modtole  is  intended  to  be  called  once  for  each  FLUTTER  subcase  in  the  boimdary 
condition.  The  ordering  of  subcases  is  that  in  the  CASE  relation.  Each  set  of  dynamic  matrices  in  the 
standard  sequence  is  saved  in  a  doubly  subscripted  set  of  matrices  to  be  used  in  sensitivity  analysis.  It 
is  not  necessary  to  save  these  matrices  unless  the  sensitivity  phase  will  be  performed. 

Error  Conditions: 

1.  Missing  damping  sets  called  for  on  the  FLUTTER  entry  are  flagged. 

2.  Errors  on  TABDMP  entries  are  flagged. 
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Engineering  Application  Module:  FLUTDRV 

Entry  Point:  FLUTDR 

Purpose: 


MAPOL  director  for  flutter  analyses. 

MAPOL  Calling  Sequence: 

CALL  FLUTDRV  {  BCID, 

SUB,  LOOP  ); 

BCID 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

SUB 

Flutter  subcase  number  (ranging  firom  1  to  the  total  number  of  FLUTTER 
subcases)  of  the  subcase  to  be  processed  in  this  pass  (Integer,  Input) 

LOOP 

Logical  flag  indicating  that  more  flutter  subcases  exist  in  the  boimdary 
condition  (Logical,  Output) 

Application  Calling  Sequence: 
None 


Method: 

The  SXJB’th  FLUTTER  subcase’s  TITLE,  SUBTITLE  and  LABEL  are  retrieved  from  the  CASE  relation  and 
set  in  the  /OUTPT2  /  common  for  downstream  page  labeling.  If  more  than  sub  flutter  subcases  exist, 
the  LOOP  flag  is  set  to  TRUE  to  tell  the  MAPOL  sequence  that  more  passes  through  the  flutter  analysis 
modules  are  needed. 

Design  Requirements: 

1.  This  module  is  the  driver  for  a  set  of  MAPOL  modules  that  together  perform  the  flutter  analysis 
for  a  subcase.  These  modules  are  flutdma,  flutqhhl  and  fluttran. 

Error  Conditions: 

None 
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Engineering  Application  Module;  FLUTQHHL 

Entry  Point:  FLTQHH 

Purpose: 

Processes  matrix  QKKL  with  normal  modes  for  flutter. 

MAPOL  Calling  Sequence: 

CALL  FLUTQHHL  (  NITER,  BCID,  SUB,  ESXZE(BC),  FSIZE(BC),  [QKKL],  [UGTKA] , 
[PHIA],  USET(BC),  [TMN(BC)],  [GSUBO(BC)],  NGDR,  AECOMPU, 
GEOMUA,  [PHIKH],  [QHHLFL (BC, SUB) ] ,  OAGRDDSP  ); 


NITER 

Design  iteration  number  (Integer,  Input) 

BCID 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

SUB 

Flutter  subcase  number  (Integer,  Input) 

ESIZE(BC) 

Number  of  extra  points  for  the  current  boundary  condition 
(Integer,  Input),  where  BC  represents  the  MAPOL  boimdary  condition 
loop  index  number 

PSIZE(BC) 

Number  of  physical  degrees  of  freedom  in  the  current  boundary  condi¬ 
tions  (gsize+ESIZE)  (Integer,  Input),  where  BC  represents  the  MAPOL 
boundary  condition  loop  index  number 

[QKKL] 

Matrix  containing  a  list  of  k  x  k  complex  unsteady  aerodynamic  matrices 
for  each  m-k  pair  defined  by  MKAEROl  and  MKAER02  entries.  These  matri¬ 
ces  were  output  from  the  AMP  module  (Input) 

[UGTKA] 

The  matrix  of  splining  coefficients  relating  the  aerodynamic  pressures  to 
forces  at  the  structural  grids  and  relating  the  structural  displacements  to 
the  streamwise  slopes  of  the  aerod3mLamic  boxes  reduced  to  the  a-set  DOF 
(Input) 

[PHIA] 

Matrix  of  normal  modes  eigenvectors  in  the  a-set  (Input) 

USET{BC) 

Current  boundary  condition’s  unstructured  entity  of  set  definition  masks 
(expanded  to  include  extra  points  and  any  GDR  scalar  points)  (Input), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number 

[TMN(BC)] 

Multipoint  constraint  transformation  matrix  for  the  current  botindary 
condition  (Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

[GSUBO(BC)] 

Static  condensation  or  GDR  reduction  matrix  for  the  current  boundary  con¬ 
dition  (Input),  where  BC  represents  the  MAPOL  boimdary  condition  loop 
index  number 

NGDR 

Denotes  dynamic  reduction  in  the  boundary  condition  (Input,  Integer) 

=  0  No  GDR 
=  -1  GDR  is  used 
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AECOMPU 


A  relation  describing  aerod3mainic  components  for  the  unsteady  aerody¬ 
namics  model.  It  is  used  in  splining  the  aerodynamics  to  the  structural 
model  (Input) 

GEOMUA  A  relation  describing  the  aerodynamic  boxes  for  the  unsteady  aerodynam¬ 

ics  model.  The  location  of  the  box  centroid,  normal  and  pitch  moment  axis 
are  given.  It  is  used  in  splining  the  aerodynamics  to  the  structure  and  to 
map  responses  back  to  the  aerodynamic  boxes  (Input) 

[PHIKH]  A  modal  tranformation  matrix  that  relates  the  box-on-box  aerodynamic 

motions  to  unit  displacements  of  the  generahzed  structural  coordinates 
(modes)  (Output) 

[  QHHLFL  ( BC ,  SUB )  ]  A  matrix  containing  the  list  of  h  x  h  unsteady  aerod3?namics  matrices  for 

the  current  flutter  subcase  related  to  the  generahzed  (modal)  coordinates 
and  including  control  eflFectiveness  (conefff),  extra  points  and  CONTROL 
matrix  inputs  (Output),  where  BC  represents  the  MAPOL  boimdary  condi¬ 
tion  loop  index  number 

OAGRDDSP  A  relation  containing  the  structural  eigenvectors  (generahzed  DOF) 

mapped  to  the  aerodynamic  boxes  for  those  AIRDISP  requests  in  the  Solu¬ 
tion  Control.  These  terms  are  the  columns  of  phikh  put  in  relational 
form  to  satisfy  the  output  requests  (Output) 

Application  Calling  Sequence: 

None 

Method: 

The  CASE  relation  is  read  to  obtain  the  SUB’th  flutter  subcase  parameters:  CONTROL  and  AIRBPRNT. 
Then  the  FLUTTER  relation  is  read  for  the  current  subcase  and  the  KLIST  and  EFFID  entries  are 
recovered. 

If  there  is  no  CONTROL  matrix,  PHIA  and  UGTKA  matrices  are  expanded  to  include  dynamic  degrees  of 
freedom  using  the  utihty  module  QHHEXP.  GDR  scalar  points  are  handled  to  ensure  that  the  final  matrices 
are  in  the  d-set.  If  a  CONTROL  matrix  does  exist,  its  conformability  is  checked.  The  DMAPVC  utility 
submodule  is  used  to  create  partitioning  vectors  and  matrix  reduction  matrices  to  allow  reduction  of 
the  CONTROL  matrix  to  the  d-set.  The  flcntr  submodule  is  then  caUed  to  append  the  reduced  CONTROL 
matrix  to  the  expanded  UGTKA  matrix.  The  PHIKH  matrix  is  then  computed  as  the  product  of  the 
expanded  PHIA  and  the  expanded  and  CONTROL-modified  UGTKA: 

[PHIKH]  =  [PHID]^[UGTKD] 

Then,  if  control  effectiveness  correction  factors  are  selected  for  the  subcase,  the  PHIKH  matrix  terms  are 
adjusted  by  the  input  factors.  This  completes  the  computation  of  the  phikh  output  matrix.  The  input 
AIRDISP  output  requests  are  then  processed  to  load  the  OAGRDDSP  relation  with  the  generalized 
displacements  on  the  unsteady  aerod3mamic  geometry. 

Finally,  the  QKK  matrices  that  are  associated  with  the  user’s  input  Mach  number  and  KLIST  for  the 
subcase  are  reduced  to  the  generahzed  degrees  of  freedom  using  the  PHIKH  matrix. 

[QHHL]  =  I  (PHIKH)  1®[QKKL]  [PHIKH] 

The  premultiplication  takes  place  in  one  mpyad  and  the  postmultiplication  is  done  by  looping  over  each 
reduced  frequency  in  the  set,  extracting  the  k  columns  of  each  h  x  k  matrix  and  performing  a  separate 
MPYAD.  The  results  are  then  appended  onto  the  output  QHHL. 
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Design  Requirements: 

None 

Error  Conditions: 

1.  CONTROL  matrix  errors  in  conformability  are  flagged. 

2.  CONKFFF  errors  are  flagged. 


Engineering  Application  Module:  FLUTSENS 
Entry  Point:  FLTSTY 


Purpose: 

To  compute  the  sensitivities  of  active  flutter  constraints  in  the  current  active  boimdary  condition. 


MAPOL  Calling  Sequence: 

CALL  FLUTSENS  (  NITER,  BCID,  SUB,  LOOP,  GSIZEB,  NDV,  6LBDES,  CONST,  GMKCT, 
DKVI,  GMMCT,  DNVI,  CIANBDA,  LAMBDA,  [QHHLFL (BC, SUB) ] , 
[MEHFL(BC,SUB}]  ,  [BHHFL  (BC,  SUB)  ]  ,  [KHHFL (BC,  SX^B)  ]  , 

[PHIG(BC)],  [AMAT]  ); 

NITER 

Design  iteration  number  (Integer,  Input) 

BCID 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

SUB 

Flutter  subcase  number  (ranging  from  1  to  the  total  number  of  FLUTTER 
subcases)  of  the  subcase  to  be  processed  in  this  pass.  (Integer,  Input) 

LOOP 

Logical  flag  indicating  that  more  flutter  subcases  exist  in  the  boundary 
condition.  (Logical,  Input) 

GSIZEB 

The  size  of  the  structural  set  (Integer,  Input) 

NDV 

The  number  of  global  design  variables  (Integer,  Input) 

GLBDES 

Relation  of  global  design  variables  (Character,  Input) 

CONST 

Relation  of  constraint  values  (Character,  Input) 

GMKCT 

Relation  containing  connectivity  data  for  the  DKVI  sensitivity  matrix 
(Character,  Input) 

DKVI 

Unstructured  entity  containing  the  stiffiiess  design  sensitivity  matrix  in 
a  highly  compressed  format  (Character,  Input) 

GMMCT 

Relation  containing  connectivity  data  for  the  dmvi  sensitivity  matrix 
(Character,  Input) 

DMVI 

Unstructured  entity  containing  the  mass  design  sensitivity  matrix  in  a 
highly  compressed  format  (Character,  Input) 

CLAMBDA 

Relation  containing  results  of  flutter  analyses  (Character,  Input) 

LAMBDA 

Relational  entity  containing  the  output  from  the  real  eigenanalysis 
(Character,  Input) 

[QHHLFL (BC, SUB)] 

Matrix  hst  of  modal  imsteady  aerodynamic  coefficients  (Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number 

[MHHFL(BC,SUE)] 

Modal  mass  matrix  (Input),  where  BC  represents  the  MAPOL  boundary 
condition  loop  index  number 

[BHHFL (BC, SUB)] 

Modal  flutter  damping  matrix  (Input),  where  BC  represents  the  MAPOL 
boundary  condition  loop  index  number 

[KHHFL(BC,SUB)] 

Modal  flutter  stiffiness  matrix  (Input),  where  BC  represents  the  MAPOL 
boundary  condition  loop  index  number 
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[PHIG(BC)] 


Matrix  of  real  eigenvectors  in  the  structural  set  (Input),  where  BC  repre¬ 
sents  the  MAPOL  boundary  condition  loop  index  number 

[AMAT]  Matrix  of  constraint  sensitivities  (Output) 

Application  Calling  Sequence: 

None 

Method: 

The  FLUTSENS  module  is  very  similar  to  the  fluttran  module  except  that  the  const  and  clambda 
relations  control  the  execution  of  the  module  rather  than  the  CASE  relation.  The  module  begins  by 
retrieving  all  the  active  flutter  constraints  from  the  CONST  relation  that  are  associated  with  the  current 
subcase  (SUB)  and  determining  the  clambda  tuples  tiiat  correspond  to  the  active  constraints.  The  next 
task  of  the  module  is  to  prepare  for  the  actual  flutter  sensitivity  analysis  by  setting  up  the  flfact  bulk 
data  and  the  dnmk  data  using  the  prefl  and  prdnmk  utihties,  respectively.  The  generalized  mass  and 
damping  matrices  are  then  read  into  memory  and  converted  to  single  precision,  followed  by  the  natural 
frequencies  associated  with  the  computed  eigenvectors.  Lastly,  the  generalized  stifBiess  matrix  is  read 
in  and  converted  to  single  precision  and  the  generalized  aerodynamic  influence  coefficients  are  opened 
for  retrieval.  A  final  operation  creates  the  scratch  flutter  eigenvector  matrices  that  will  be  used  in  the 
sensitivity  evaluation. 

For  the  FLUTTER  case,  a  nrunber  of  tasks  are  performed  to  set  up  for  the  current  Mach  number.  These 
consist  of  the  retrieval  of  the  set  of  m-k  pairs  for  the  current  flutter  entry  from  the  unmk  data  and 
the  set  of  normal  modes  that  are  to  be  omitted.  If  modes  are  omitted,  a  partitioning  vector  is  created 
and  used  to  partition  the  input  PHIG  matrix  to  include  only  the  desired  normal  modes.  As  a  final  step 
before  the  active  constraint  loop  for  the  current  flutter  set  id,  the  local  memory  required  by  the  flutter 
analysis  submodules  is  retrieved. 

The  module  continues  with  the  loop  on  the  CLAMBDA  tuples  associated  with  the  current  FLUTTER  set 
identification  number.  The  scalar  parameters  identifying  the  flutter  root  are  retrieved  from  CLA^DA 
and  the  set  of  reduced  frequencies  associated  with  the  QHLL  matrices  for  this  flutter  case  are  retrieved 
from  the  UNMK  data.  The  FAIPKI  submodule  is  called  with  this  data  to  compute  the  interpolation  matrix 
for  the  QHLL  matrix  hst  under  the  ORIG  curve  fit  option.  Otherwise,  the  fitting  coefficients  are  computed 
on  the  fly  within  the  QFDRV  family  of  routines.  Then,  the  subset  of  the  full  QHLL  matrix  associated  with 
this  flutter  analysis  is  read  into  core  and  converted  to  single  precision. 

At  this  point,  the  imaginary  part  of  the  QZHH  matrix  is  divided  by  the  reduced  frequency.  Finally,  the 
QFDRV  utility  is  called  to  generate  the  QRS  interpolated  aerodynamic  influence  coefficients  for  the 
current  flutter  eigenvalue.  At  the  same  time  the  QFDRV  module  computes  the  sensitivity  of  this  matrix 
to  the  reduced  frequency  (DQRS).  Finally,  the  flutter  eigenmatrix  is  computed  using  the  fsubs  sub- 
module.  The  corresponding  right-hand  eigenvector  is  then  computed,  the  eigenmatrix  is  transposed  and 
the  left-hand  vector  computed.  At  this  point,  the  scalar  (complex)  sensitivities  of  the  mass,  damping, 
stiffiiess  and  aerodynamics  are  computed  as  outlined  in  Section  10.3  of  frie  Theoretical  Manual.  The 
FLUTSENS  module  performs  all  these  computations  using  real  arithmetic.  Finally,  the  2X2  left-hand 
side  matrices  of  equation  10-27  of  the  Theoretical  Manual: 

P2R  *  MR  -  P2I  *  MI  -t-  KR  +  damping' 

P2R  *  MI  -  P2I  *  MR  -I-  KI  +  damping 

are  stored  and  the  left-  and  right-hand  eigenvectors  packed  into  a  scratch  entity.  The  value  damping 
is: 
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I  -g  *  KI  1 
[  g  *  KR  J 

if  structural  damping,  g,  is  included. 
Similarly,  it  is: 


[  PIR  *  *  KR  -  PlI  *  *  KI 

CO.  (0, 

^  \ 

PIR  *  -9^  *  KI  -  PlI  *  -2.  *  kR 

I  "^3  J 

if  equivalent  viscous  damping  is  used  at  frequency  cos. 

The  module  then  continues  with  the  next  active  constraint  for  the  current  FLUTTER  entry.  Once  all  the 
active  constraints  are  treated  for  the  current  flutter  entry,  the  matrix  of  left-  and  right-hand 
eigenvectors  are  expanded  to  physical  coordinates  using  the  (partitioned)  normal  modes  matrix.  The 
FLCSTY  module  is  then  called  to  complete  the  solution  of  the  constraint  sensitivities  to  the  global  design 
variables.  These  computations  involve  the  eigenvectors  and  the  mass,  damping  and  stiffiiess  sensitivi¬ 
ties  to  compute  the  right-hand  side  of  the  equations  shown  in  the  Theoretical  Manual.  The  flutter 
response  sensitivities  which  are  required  by  the  active  user  function  constraints  are  also  computed  in 
this  module.  Once  the  FLCSTY  module  is  complete,  the  FLUTSENS  module  proceeds  with  the  next 
FLUTTER  entiy  with  active  flutter  constraints.  When  all  have  been  completed,  control  is  returned  to  the 
executive. 

Design  Requirements: 

1.  The  module  assumes  that  at  least  one  active  flutter  constraint  exists  in  the  current  boimdary 
condition. 

Error  Conditions: 

None 
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Engineering  Application  Module:  FLUTTRAN 
Entry  Point:  FLUTAN 


Purpose: 

lb  perform  flutter  analyses  in  the  current  boundary  condition  and  to  evaluate  any  flutter  constraints  if 
it  is  an  optimization  boundary  condition  with  applied  flutter  constraints. 

MAPOL  Calling  Sequence: 

CALL  PLUTTRAN  (  NITER,  BCID,  SUB,  [QHHLFL (BC, SUB) ] ,  LAMBDA,  HSIZE(BC), 

ESIZE(BC),  [MHHFL(BC,SUB)],  [BHHPL (BC, SUB) ] ,  [KHHFL (BC, SOT) ] , 
CLAMBDA,  CONST  ); 


NITER 

BCID 

SOT 

[ QHHLFL (BC, SOT)] 
LAMBDA 

BSIZE(BC) 

ESIZE(BC) 

[MHHFL(BC,SOT) 1 
[BHHFL(BC,SOT)] 
[KHHFL (BC, SOT)] 
CLAMBDA 


Design  iteration  number  (Integer,  Input) 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

Flutter  subcase  number  (ranging  from  1  to  the  total  number  of  FLUTTER 
subcases)  of  the  subcase  to  be  processed  in  this  pass.  (Integer,  Input) 

Matrix  list  of  modal  unsteady  aerodynamic  coefficients  (Input) 

Relational  entity  containing  the  output  firom  the  real  eigenanalysis 
(Input) 

Number  of  modal  d3mamic  degrees  of  freedom  in  the  current  boundary 
condition  (Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

The  number  of  extra  point  degrees  of  freedom  in  the  boundary  condition 
(Integer,  Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

Modal  mass  matrix  (Input),  where  BC  represents  the  MAPOL  boundary 
condition  loop  index  number 

Modal  flutter  damping  matrix  (Input),  where  BC  represents  the  MAPOL 
boundary  condition  loop  index  number 

Modal  flutter  stiffiiess  matrix  (Input),  where  BC  represents  the  MAPOL 
boimdary  condition  loop  index  number 

Relation  containing  results  of  flutter  analyses  (Character,  Output) 


CONST 


Relation  of  constraint  values  (Character,  Input) 


Application  Calling  Sequence: 

None 

Method: 

The  FLUTTRAN  module  begins  by  retrieving  the  flutter  discipline  entries  from  the  CASE  relation  for  the 
current  boundary  condition.  If  the  boundary  condition  is  an  optimize  boundary  condition,  the  CONST 
and  CLAMBDA  relations  are  opened  to  store  the  constraint  and  root  extraction  data  needed  for  the 
optimization  task.  For  analysis  boimdary  conditions,  the  hidden  entities  FLUTMODE  and  FLUTREL  are 
opened  and  initialized  to  prepare  for  possible  flutter  mode  shape  storage.  These  mode  shapes  are  stored 
so  that  the  OFPDISP  module  can  satisfy  flutter  mode  shape  print  requests. 
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The  next  task  of  the  module  is  to  prepare  for  the  actual  flutter  analysis  by  setting  up  the  flfact  bulk 
data  and  the  unmk  data  using  the  prefl  and  PRtJUMK  utilities,  respectively.  Then  the  reference  unsteady 
aerodynamic  model  data  is  retrieved  from  the  AERO  relation.  Lastly,  the  velocity  conversion  factor,  if 
one  has  been  defined,  is  read  from  the  convert  relation.  The  generalized  mass  and  damping  matrices 
are  then  read  into  memory  and  converted  to  single  precision,  followed  by  the  natural  frequencies 
associated  with  the  computed  eigenvectors.  Lastly,  the  generalized  stifbiess  matrix  is  read  in  and 
converted  to  single  precision  and  the  generalized  aerod3mamic  influence  coefficients  are  opened  for 
retrieval.  This  completes  the  preparations  for  the  flutter  discipline  loop. 

For  the  suB’th  flutter  discipline  requested  in  the  case  relation,  a  number  of  tasks  are  performed  to  set 
up  for  the  Mach  number  requested  on  the  flutter  entry.  These  consist  of  the  retrieval  of  the  set  of  m-k 
pairs  for  the  current  FLUTTER  entry  from  the  unmk  data  and  the  hsts  velocities  (which  are  converted  to 
the  proper  units,  if  necessary)  and  densities.  If  the  boundary  condition  is  an  optimization  boundary 
condition,  the  table  of  required  damping  values  is  prepared  using  the  prfcon  utility.  Lastly,  the  set  of 
normal  modes  that  are  to  be  omitted  are  retrieved  and  the  data  prepared  to  perform  the  "partitioning" 
of  the  generalized  matrices.  As  a  final  step  before  processing  the  current  FLUTTER  entry,  the  local 
memory  required  by  the  flutter  analysis  submodules  is  retrieved. 

The  subset  of  m-k  pairs  in  the  QHLL  matrix  list  for  the  current  Mach  number  is  determined  and  the  set 
of  associated  reduced  frequencies  determined.  The  FAIPKX  submodule  is  called  with  this  data  to 
compute  the  interpolation  matrix  for  the  QHLL  matrix  list  if  the  ORXG  curve  fit  is  used.  Otherwise,  the 
fitting  coefficients  are  computed  on  the  fly  in  the  qfdrv  module.  Then,  the  subset  of  the  full  qhll  matrix 
associated  with  this  flutter  analysis  is  read  into  core  and  converted  to  single  precision.  At  this  point, 
the  imaginary  part  of  the  QZHH  matrix  is  divided  by  the  reduced  frequency.  Finally,  the  Mach  ncunber 
dependent  memory  blocks  are  retrieved  and  the  inner-most  analysis  loop  on  the  density  ratios  is  begun. 

For  each  density  ratio  associated  with  the  Mach  number  for  the  current  flutter  analysis  discipline,  the 
FLUTTRAN  module  performs  the  flutter  analysis.  There  are  two  distinct  paths  through  the  inner  loop: 
one  for  optimization  and  one  for  analysis.  They  differ  in  that  the  analysis  loop  refines  the  set  of  user 
selected  velocities  to  find  a  flutter  crossing,  while  the  optimization  path  computes  the  flutter  eigenvalues 
only  at  the  user  specified  velocities  3ind  computes  the  corresponding  flutter  constraiint  value  based  on 
the  required  damping  table.  Once  all  the  loops  have  been  completed,  the  module  computes  the  flutter 
responses  which  are  required  by  any  user  function  constraints,  and  then  returns  control  to  the  executive. 

Design  Requirements: 

1.  The  module  assumes  that  at  least  one  flutter  subcase  exists  in  the  current  boundary  condition. 

Error  Conditions: 

1.  Referenced  data  on  flutter  entries  that  do  not  exist  on  the  data  base  Eire  flagged  and  the  execution 
is  terminated. 
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Engineering  Application  Module:  FNEVAL 

Entry  Point:  FNEVAL 

Purpose: 

Evaluates  the  current  values  of  user  functional  constraints. 

MAPOL  Calling  Sequence: 

CALL  FNEVAL  (  NITER,  CONST  ); 

NITER  Design  iteration  nximber  (Integer, Input) 

CONST  Relation  of  constraint  values  (Character, Output) 

Application  Calling  Sequence: 

None 

Method: 

This  module  first  computes  the  user  defined  objective  function  value  if  it  is  required.  This  objective 
function  value  is  stored  in  relation  CONST  with  the  OBJECTIVE  indication  flag  set.  The  function  value 
is  set  to  be  "active"  so  that  its  required  response  sensitivities  will  be  computed  thereafter.  Then,  all 
instances  invoked  by  the  objective  are  computed.  They  are  treated  as  subcase  independent  user 
functional  constraints. 

Finally,  case  dependent  user  functional  constraints  are  computed  for  each  subcase  for  which  functional 
constraints  have  been  specified.  All  user  function  values  are  computed  using  the  evaluation  utilities. 
These  utilities  retrieve  ^  required  response  function  values. 

Design  Requirements: 

1.  All  response  functions  must  be  computed  prior  to  this  module. 

Error  Conditions: 

None 
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Engineering  Application  Module:  FPKEVL 

Entry  Point:  FPKEVL 

Purpose: 

Compiles  the  FUNCTION  packet  and  instantiates  the  user  functions  that  have  been  invoked  by  Solution 
Control. 

MAPOL  Calling  Sequence: 

CALL  FPKEVL  (  EIDTYPE  ); 

EIDTYPE  Relation  containing  element  identification  numbers  and  corresponding 

element  type  (Character, Input) 

Application  Calling  Sequence: 

None 

Method: 

This  module  compiles  the  function  packet  statements  and  loads  the  compiled  information  onto  the 
CADDB  database.  Compilation  determines  the  validity  of  each  function  in  terms  of  its  syntax  and  the 
other  functions  it  may  use.  Once  the  vahdity  of  the  functions  is  determined,  each  function  is  instantated. 
Instantiation  determines  that  the  supporting  Bulk  Data,  if  any,  is  present  on  the  database  and  the  actual 
number  of  instances.  The  instantiation  process  creates  the  data  structures  that  describe  each  constraint. 
These  data  structures  are  then  used  by  ASTROS  to  request  the  computation  of  the  constituent  responses. 

Design  Requirements: 

1.  A  Function  packet  must  be  included  in  the  input  data  stream. 

Error  Conditions: 

1 .  S3mt ax  errors  and  inconsistent  or  illegal  function  requests  are  flagged  and  the  execution  is  terminated. 
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Engineering  Application  Module:  FREDUCE 
Entry  Point:  FREDUC 


Purpose: 

lb  reduce  the  S3nnmetric  or  asymmetric  f-set  stiffness,  mass  and/or  loads  matrix  to  the  a-set  if  there  are 
omitted  degrees  of  freedom. 


MAPOL  Calling  Sequence: 

CALL  FREDUCE  {  [KFF] ,  [PF] ,  [PFOA(BC)],  SYM,  [KOOINV(BC) ] ,  [KOOU(BC)], 
[KAO(BC)],  [GSUBO(BC)],  [KAA] ,  [PA],  [PO] ,  USET(BC)  )f 


[KFF] 

Optional  Stiffiiess  or  mass  matrix  to  be  reduced  (Input) 

[PF] 

Optional  loads  matrix  to  be  reduced  (Input) 

[PFOA(BC)] 

The  partitioning  vector  splitting  the  free  degrees  of  freedom  into  the 
analysis  set  and  the  omitted  degrees  of  freedom  (Input),  where  BC  repre¬ 
sents  the  MAPOL  boundary  condition  loop  index  number 

SYM 

Optional  symmetry  flag;  =1  if  KFF  is  not  symmetric  (Integer,  Input) 

[KOOlNVfBC)] 

Matrix  containing  the  inverse  of  KOO  for  symmetric  stif&ess  matrices  or 
the  lower  triangular  factor  of  KOO  for  asymmetric  matrices  (Output), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number 

[KOOU{BC) ] 

Optional  matrix  containing  the  upper  triangular  factor  of  KOO  for  asym¬ 
metric  stiffiiess  matrices  (Output),  where  BC  represents  the  MAPOL 
boundary  condition  loop  index  number 

[KAO(BC)] 

Optional  matrix  containing  the  off-diagonal  partition  of  KFF  required  for 
recovery  when  KFF  is  asymmetric  (Output),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  nimiber 

[GSUBO(BC)] 

Matrix  containing  the  static  condensation  transformation  matrix 
(Input  and  Output),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

[KAA] 

The  stiffness  matrix  in  the  analysis  set  degrees  of  freedom  (Output) 

[PA] 

The  loads  matrix  in  the  analysis  set  degrees  of  freedom  (Output) 

[PO] 

Matrix  containing  the  loads  on  the  omitted  degrees  of  freedom  (Output) 

USET(BC) 

The  unstructured  entity  defining  structural  sets  (Character,  Input), 
where  BC  represents  the  MAPOL  boimdary  condition  loop  index  number 

Application  Calline  Sequence: 

None 


Method: 

FREDUCE  module  begins  by  checking  if  the  KFF  argument  is  nonblank.  If  so,  the  reduction  by  static 
condensation  is  performed  in  one  of  two  ways  depending  on  the  SYM  flag.  If  the  SYM  flag  is  zero  or  omitted 
from  the  calling  sequence  the  following  operations  are  performed: 
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r  1 

KOO 

KOA  " 

KFF 

L  J 

KOA^ 

KAA 

[KOOINV]  =  [KOO]  ^  symmetric  decomposition 

[GSUBO]  =  -  [KOOINV]  [KOA]  symmetric  Forward-Backward  Substition 


r 

-  -  -I  p  -|T 

r  T 

KAA 

— 

KAA  +  KOA 

1  GSUBO  J 

The  KOOINV,  GSXIBO  and  kaa  arguments  must  be  nonblank  in  the  calling  sequence.  If  the  SYM  flag  is 
nonzero  in  the  calling  sequence  the  following  operations  are  performed: 


r  1 

’  KOO 

KOA  ■ 

KFF 

L  J 

KAO 

KJ^ 

[KOOINV]  and  [KOOU]  are  the  Lower  and  Upper  triangular  factors  of  [KOO] 

[GSUBO]  =  -  [KOO]  [KOA]  asymmetric  Forward-Backward  Substition 
[KAA]  =  [KAA]  +  [KAO]  [GSUBO] 

The  KOOINV,  KOOU,  KAO,  GSUBO  and  KAA  arguments  must  be  nonblank  in  the  calling  sequence.  Note 
that  KAO  is  required  since  the  asymmetric  nature  of  KFF  prohibits  the  transpose  operation  used  in  the 
S3mmetric  case.  The  modxile  then  checks  if  PF  is  nonblank.  If  so,  the  loads  matrix  reduction  is  performed. 
Once  again,  there  are  two  paths  depending  on  the  S3mmetry  flag.  If  SYM  is  zero  (symmetric),  the 
following  operations  are  performed: 


1 

f  PO  ] 

[pf] 

^  J 

[  PA  j 

[SCRl]  =  [PO]*^  [GSUBO] 
[SCR2]  =  [SCRl]^ 

[PA]  =  [^]  +  [SCR2] 
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With  the  odd  order  of  operations  dictated  by  efSciency  considerations  in  the  matrix  operations.  Note 
that  the  GSDBO,  pa  and  PO  arguments  must  be  nonblank  with  the  GSXiBO  argument  an  input  if  the 
stiffiiess  matrix  was  not  simultaneously  reduced.  If  SYM  is  nonzero  (asymmetric),  the  following 
operations  are  performed; 


r  n 

r  PO  ] 

[ 

^  1 

[  PA  j 

[SCRl]  =  IKOOl"^  [PO]  (Asymmetric  FBS) 

[PA]  =  [PA]  +  [KAO]  [SCRl] 

Note  that  the  kooinv,  koou,  kao,  pa  and  PO  arguments  must  be  supplied  with  the  KOOINV,  KOOU, 
emd  KAO  arguments  input  if  the  (asymmetric)  stififtiess  matrix  is  not  being  reduced  in  the  same  call. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  freqsens 


Entry  Point:  FQCSTY 


Purpose: 

To  compute  the  sensitivities  of  active  frequency  constraints  in  the  current  active  boundary  condition. 
MAPOL  Calling  Sequence: 

CALL  FREQSENS  (  NITER,  BCID,  NDV,  GLBDES,  CONST,  LAMBDA,  GMKCT,  DKVI,  GMMCT, 
DMVI,  [PHIG(BC)],  [AMAT]  ); 


NITER 

BCID 

NDV 

GLBDES 

CONST 

LAMBDA 

GMKCT 

DKVT 

GMMCT 

DMVI 

[PHIG{BC)] 

[AMAT] 


Design  iteration  number  (Integer,  Input) 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

Number  of  design  variables  (Integer,  Input) 

Relation  of  global  design  variables  (Character,  Input) 

Relation  of  constraint  values  (Character,  Input) 

Relational  entity  containing  the  output  from  the  real  eigenanalysis 
(Input) 

Relation  containing  connectivity  data  for  the  DKVI  sensitivity  matrix 
(Character,  Input) 

Unstructured  entity  containing  the  stiffness  design  sensitivity  matrix  in 
a  highly  compressed  format  (Character,  Input) 

Relation  containing  connectivity  data  for  the  DMVI  sensitivity  matrix 
(Character,  Input) 

Unstructured  entity  containing  the  mass  design  sensitivity  matrix  in  a 
highly  compressed  format  (Character,  Input) 

Matrix  of  eigenvectors  for  the  current  boimdary  condition  (Input),  where 
BC  represents  the  MAPOL  boundary  condition  loop  index  number 

Matrix  containing  the  sensitivities  of  the  constraints  to  the  design  vari¬ 
ables  (Output) 


Application  Calling  Sequence: 
None 


Method: 

This  module  first  computes  the  frequency  response  sensitivities  which  are  required  by  the  active  user 
function  constraints.  Then  it  obtains  design  variable  information  from  GLBDES,  frequency  constraint 
information  firom  CONST  and  eigenvalue  information  from  LAMBDA.  Space  is  reserved  for  design 
sensitivity  matrices  and  then  the  number  of  eigenvectors  that  can  be  held  in  core  simultaneously  is 
determined.  Spill  logic  is  provided  if  this  number  is  less  than  the  number  of  eigenvectors  that  have 
eigenvalue  constraints.The  eigenvectors  are  read  into  core  and  a  loop  on  the  design  variables  brings  the 
connectivity  data  into  core.  Calls  to  TUNMLS/D  perform  the  required  triple  matrix  products  involving 
the  eigenvector  and  the  design  sensitivity  matrices.  This  information  is  required  to  form  the  frequency 
constraint  information,  which  is  written  to  the  AMAT  matrix. 

Design  Requirements: 
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1.  The  module  is  only  called  if  there  are  active  frequency  constraints  and  therefore  must  follow  the 
ABOUND  module. 

2.  The  DESIGN  module  makes  the  assumption  that  data  were  written  to  amat  from  this  module  prior 
to  any  subcase  dependent  sensitivities. 

Error  Conditions: 


None 


Engineering  Application  Module:  FSD 


Entry  Point:  FSDDRV 


Purpose: 

To  perforin  redesign  by  Fully  Stressed  Design  (fsd)  methods  based  on  the  set  of  applied  stress 
constraints.  All  other  applied  constraints  are  ignored. 

MAPOL  Calling  Sequence: 

CALL  FSD  (  NDV,  NITER,  FSDS,  FSDE,  MPS,  OCS,  ALPHA,  CNVRGLIM,  GLBDES, 

LOCLVAR,  IPTRANS],  CONST,  APPCNVRG,  CTL,  CTLMIN,  DESHIST  ); 


NDV 

NITER 

FSDS 

FSDE 

MPS 

OCS 

ALPHA 

CNVRGLIM 

GLBDES 

LOCLVAR 

[PTRANS] 

CONST 

APPCNVRG 

CTL 

CTLMIN 

DESHIST 


The  number  of  global  design  variables  (Integer,  Input) 

Iteration  number  for  the  current  design  iteration  (Integer,  Input) 

The  first  iteration  to  use  FSD  (Integer,  Input) 

The  last  iteration  to  use  FSD  (Integer,  Input) 

The  first  iteration  to  use  math  programming  (Integer,  Input) 

The  first  iteration  to  use  optimality  criteria  (Integer,  Input) 

Exponential  move  limit  for  the  FSD  algorithm  (Real,  Input) 

Relative  percent  change  in  the  objective  function  that  indicates  approxi¬ 
mate  problem  convergence  (Real,  Input) 

Relation  of  global  design  variables  (Character,  Input) 

Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Character,  Input) 

The  design  variable  linking  matrix  (Character,  Input) 

Relation  of  constraint  values  (Character,  Input) 

The  approximate  problem  converge  flag  (Logical,  Output) 

=  FALSE  if  not  converged 

=  TRUE  if  converged  in  objective  function  value  and  design  vector  move 
Tolerance  for  indicating  an  active  constraint  (Real,  Output) 

Tolerance  for  indicating  a  violated  constraint  (Real,  Output) 

Relation  of  design  iteration  information  (Character,  Output) 


Application  Calling  Sequence: 
None 


Method: 

The  first  task  performed  in  the  FSD  module  is  to  determine  if  the  FSD  option  is  to  be  used.  The  assumption 
of  the  module  is  that  the  Solution  Control  STRATEGY  requests  have  been  satisfied  by  the  MAPOL 
sequence  such  that,  if  FSD  is  called,  FSD  has  been  requested  by  the  user  for  this  iteration. 

The  module  checks  that  the  alpha  parameter  is  a  legal  value  (>0 . 0).  If  it  is  not,  the  default  value  of 
0.50  is  used.  Then  FSD  brings  the  required  data  into  memory.  These  data  consist  of  the  local  design 
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variable  data  (in  the  ptrans,  loclvar  and  glbdes  entities),  which  are  accessed  through  the  design 
variable  utility  module  preldv  with  entry  points  ldvpnt  and  getldv.  Finally,  the  const  relation 
tuples  associated  with  the  stress  constraints  are  retrieved.  If  no  stress  constraints  are  foimd,  the  module 
cannot  do  any  resizing  and  so  modifies  the  MAPOL  control  parameters  FSDS,  fsde,  mps  and  ocs  as 
outlined  below  to  prevent  the  further  use  of  PSD  in  subsequent  iterations. 

If  the  appropriate  constraints  were  foimd,  the  module  loops  through  each  local  design  variable  ^d 
determines  which  (if  any)  stress  constraint  is  associated  with  that  variable.  When  the  matching 
constraint  is  found,  the  new  local  variable  is  computed  fi-om: 


tnew  —  is  ) 

If  any  shape  function  linked  local  variables  are  encoimtered  during  this  phase,  the  starting  and  ending 
iterations  (FSDS  and  FSDE)  and  the  appropriate  other  starting  iteration  number  (the  lesser  of  MPS  ^d 
ocs)  are  modified  such  that  FSD  will  not  be  called  again.  Then  execution  is  returned  to  the  executive. 
This  prevents  any  further  attempts  to  use  PSD  with  the  shape  function  linking  and  directs  that  the 
current  iteration  be  performed  used  the  appropriate  alternative  method.  A  warning  is  given  and  the 
execution  continues. 


Once  the  vector  of  new  local  variables  are  retrieved,  the  PTRANS  data  is  brought  into  memory  along  with 
the  GLBDES  data.  The  GLBDES  data  sure  used  to  reset  any  local  variable  values  that  are  outside  their 
valid  ranges  to  maximum  or  minimum  gauge.  Then  the  new  vector  of  global  variables  are  computed  as: 


( tneiv] 


Vnew  —  inax 

p, 

These  constitute  the  new  design  from  the  FSD  algorithm  and  are  stored  back  to  the  GLBDES  relation. 
The  DESHIST  relation  is  updated  and  an  informational  message  indicating  the  changes  in  the  objective 
function  is  written.  The  active  and  violated  constraint  tolerances  are  set  to  their  FSD  default  values: 
CTL=-1 . 0  X  10”^  and  CTLMIN=5 .  OxlO"^.  This  completes  the  action  of  the  PSD  module. 


Design  Requirements: 

1.  Only  stress  constraints  (strain  constraints  are  excluded)  are  considered  in  the  FSD  module.  If  none 
are  found,  the  module  terminates  cleanly  with  the  FSD  selection  flags  reset  to  avoid  any  further  PSD 
cycles. 

2.  Shape  function  design  variable  linking  causes  the  module  to  terminate  cleanly  with  the  FSD  selection 
flags  reset  to  avoid  any  further  FSD  cycles. 

Error  Conditions: 

None 
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Engineering  Application  Module:  GDRl 

Entry  Point:  GDRDRl 

Purpose: 

To  compute  the  shifted  stiffness  matrix  and  the  rigid  body  transformation  matrix  [6G0]  to  be  used  in 
phase  2  of  Generahzed  Dynamic  Reduction. 

MAPOL  Calling  Sequence: 

CALL  6DR1  (  [KOO] ,  [UOO] ,  [KSOO] ,  [6G0] ,  LKSET,  LJSET,  MEIV,  FMAX,  BCID/ 

BGPDT(BC),  USET(BC),  NOMIT,  LSIZE  ); 


[KOO] 

Stiffiiess  matrix  in  the  o-set  (Input) 

[MOO] 

Mass  matrix  in  the  o-set  (Input) 

[KSOO] 

Shifted  KOO  matrix  (Output) 

[GGO] 

Matrix  to  compute  displacements  at  the  g-set  due  to  displacements  at  the 
origin  (Output) 

LKSET 

Length  of  the  k-set  vectors,  LKSET  =  -1  if  there  is  no  k-set 
(Integer,  Output) 

LJSET 

Length  of  the  j-set,  L  JSET=  -1  if  there  is  no  jset 

NEIV 

Computed  number  of  eigenvalues  below  FMAX  (Integer,  Output) 

FMAX 

Maximum  frequency  of  interest.  This  is  user  supplied  through  the 

DYMRED  entry,  but  may  be  modified  after  output  to  give  the  desired  num¬ 
ber  of  eigenvalues  on  input  to  GPR2  (Real,Output) 

BCID 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

BGPDT(BC) 

Relation  of  basic  grid  point  coordinate  data  (Input),  where  BC  represents 
the  MAPOL  boundary  condition  loop  index  number 

USET(BC) 

The  rmstructured  entity  defining  structural  sets  (Input),  where  BC  repre¬ 
sents  the  MAPOL  boundary  condition  loop  index  number 

NOMIT 

The  number  of  DOF  in  the  o-set  (Integer,  Input) 

LSIZE 

The  number  of  DOF  in  the  L-set  (Integer,  Input) 

Application  Calling  Sequence: 

None 

Method: 

The  module  begins  by  calling  subroutine  GDRIS  to  input  bulk  data  information.  NEIV,  the  niimber  of 
eigenvalues,  is  then  determined  using  FMAX  and  the  Sturm  sequence  theorem.  The  LJSET  parameter 
is  computed  as  a  combination  of  structural  DOF  in  the  a-set  plus  any  user  input  nonstructural  DOF. 
The  LKSET  parameter  is  specified  to  be  1 . 5  *NEIV  and  the  shift  parameter  is  computed  based  on  FMAX, 
LKSET  and  the  machine  precision.  The  shifted  stifihess  matrix  is  then  computed,  the  GGO  matrix  is 
computed  and  control  is  retximed  to  the  executive. 
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Design  Requirements: 

1.  This  module  is  an  alternative  to  Guyan  reduction  and  therefore  parallels  the  reduction  to  the  a-set. 
Error  Conditions: 

1.  j-set  DOF  have  been  constrained 

2.  o-set  does  not  exist 

3.  Only  a  subset  of  roots  are  guaranteed  to  be  accurate. 
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Engineering  Application  Module:  GDR2 

Entry  Point:  GDRDR2 

Purpose: 

lb  compute  the  orthogonal  basis  [PHIOK]  for  the  subspace  to  be  used  in  phase  3  of  Generalized  Dynamic 
Reduction. 


MAPOL  Calling  Sequence: 

CALL  GDR2  (  [LSOO] ,  [MOO],  [PHIOK],  LKSET,  LJSET,  NEIV,  FMAX,  BCID  ) ; 


[LSOO] 

Decomposed  shifted  stifl6iess  matrix  (Input) 

[MOO] 

Mass  matrix  in  the  o-set  (Input) 

[PHIOK] 

Matrix  of  approximate  vectors  (Output) 

LKSET 

Length  of  the  k-set  vectors  (Integer,  Input) 

LJSET 

Not  used 

NEIV 

Number  of  eigenvalues  below  FMAX  (Integer,  Input) 

FMAX 

Maximum  frequency  of  the  NEIV  eigenvalues  (Real,Input) 

BCID 

User  defined  boimdary  condition  identification  number  (Integer,  Input) 

Application  Calling  Sequence: 

None 

Method: 

After  performing  initialization  tasks,  random  starting  vectors  are  generated  and  an  iteration  procedure 
is  performed  to  obtain  an  initial  set  of  solution  vectors.  These  solution  vectors  are  transformed  into  a 
orthogonal  base  for  the  approximate  vectors.  If  an  insufficient  nrunber  ( «  LKSET  )  vectors  are  generated 
by  this  process,  additional  solution  vectors  are  obtained  and  transformed. 

Design  Requirements: 

1.  This  module  follows  GDRl  and  a  decomposition  of  KSOO  into  LSOO. 

2.  If  LKSET  is  zero  in  the  standard  MAPOL  sequence,  6DR2  is  not  called. 
Error  Conditions: 

None 
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Engineering  Application  Module:  GDR3 
Entry  Point:  GDRDR3 


Purpose: 

Tb  compute  the  transformation  matrix  [GSUBO]  for  Generalized  Dynamic  Reduction. 

MAPOL  Calling  Sequence: 

CALL  GDR3  (  [KOO] ,  [KOA] ,  [MGG] ,  [PHIOK] ,  [TMN{BC)],  [GGO] ,  [PGMN(BC)], 

[PNSF{BC)],  [PFOA(BC)],  [GSUBO(BC)],  BGPDT(BC),  USET(BC),  LKSET, 
LJSET,  ASIZE,  GNORM,  BCID  ); 


[KOO] 

[KOA] 

[MGG] 

[PHIOK] 

[TMN(BC)] 


[GGO] 

[PGMN(BC)] 
[PNSF{BC)] 
[PFOA(BC) ] 
[GSUBO (BC) ] 


BGPDTCBC) 


USET(BC) 


LKSET 

LJSET 

ASXZE 

GNORM 

BCID 

BC 


Stif&iess  matrix  in  the  o-set  (Input) 

Partition  of  the  stif&iess  matrix  (Input) 

Mass  matrix  in  the  g-set  (Input) 

Matrix  of  approximate  eigenvectors  (Input) 

Matrix  relating  m-set  and  n-set  DOF’s  (Input),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  number 

Rigid  body  transformation  matrix  (Input) 

Partitioning  vector  from  g  to  m  and  n-sets  (Input),  where  BC  represents 
the  MAPOL  boundary  condition  loop  index  number 

Partitioning  vector  from  n  to  s  and  f-sets  (Input),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  number 

Partitioning  vector  from  f  to  o  and  a-sets  (Input),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  number 

General  transformation  matrix  for  dynamic  reduction  (Output),  where  BC 
represents  the  MAPOL  bovmdary  condition  loop  index  number 

Relation  of  basic  grid  point  coordinate  data  (Input),  where  BC  represents 
the  MAPOL  bomdary  condition  loop  index  number 

The  unstructured  entity  defining  structural  sets  (Input),  where  BC  repre¬ 
sents  the  MAPOL  boundary  condition  loop  index  number 

Length  of  the  k-set  (Integer,  Input) 

Length  of  the  j-set  (Integer,  Input  and  Output) 

The  number  of  DOF’s  in  the  A-set  (Integer,  Input) 

The  sum  of  LKSET  and  LJSET  (Integer,  Output) 

Boundeuy  condition  identification  number  (Integer,  Input) 

Boundary  condition  index  number  (Integer,  Input) 
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Application  Calling  Sequence: 

None 

Method: 

The  module  calculates  an  overall  transformation  matrix  which  relates  DOF’s  in  the  a-,  j-  and  k-sets  to 
the  o-set.  The  task  is  simplified  if  some  of  the  sets  are  empty. 

Design  Requirements: 

1.  This  module  must  follow  GDRl. 

2.  If  LKSET  is  nonzero,  6DR2  must  also  have  been  called. 

Error  Conditions: 

None 
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Engineering  Application  Module;  6DR4 

Entry  Point:  GDRDR4 

Purpose: 

Tb  compute  updated  transformations  between  displacement  sets.  Useful  for  data  recovery  from  Gener¬ 
alized  Dynamic  Reduction. 

MAPOL  Calling  Sequence: 

CALL  GDR4  {  BCID,  GSIZE,  PSIZE(BC) ,  LKSET,  LJSET,  [PGMN(BC)],  [TMN(BC)], 
[PNSF(BC)],  [PFOA(BC)],  [PARL(BC)],  [PGDRG(BC)],  [PAJK] , 

[PFJK],  BGPDT{BC),  USET(BC)  ); 


BCID 

User  defined  boimdary  condition  identification  number  (Integer,  Input) 

GSIZE 

Length  of  the  g-set  vector  (Integer,  Input) 

PSIZE(BC) 

The  size  of  the  physical  set  for  the  current  boundary  condition.  (Integer, 
Input),  where  BC  represents  the  MAPOL  boundary  condition  loop  index 
number 

LKSET 

Length  of  the  k-set  (Integer,  Input) 

LJSET 

Length  of  the  j-set  (Integer,  Input) 

[PGKM(BC)] 

Partitioning  vector  from  g  to  m  and  n-sets  (Input),  where  BC  represents 
the  MAPOL  boundary  condition  loop  index  number 

[TMNfBC)] 

Matrix  relating  m-set  and  n-set  DOF’s  (Input),  where  BC  represents  the 
MAPOL  boimdary  condition  loop  index  number 

[PNSF(BC)] 

Partitioning  vector  from  n  to  s  and  f-sets  (Input),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  number 

[PFOA{BC)] 

Partitioning  vector  from  f  to  o  and  a-sets  (Input),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  number 

[PARL(BC)] 

Modified  partitioning  vector  to  partition  the  a-set  to  r  and  1-sets  (Output), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number 

[PGDRG(BC)] 

A  partitioning  vector  that  removes  the  additional  GDR  scalar  points  from 
the  g-set  sized  displacement  and  acceleration  vectors.  (Output),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number 

[PAJK] 

Partitioning  vector  to  divide  the  a-set  DOFs  that  may  include  GDR  gener¬ 
ated  scalar  points  into  the  original  a-set  DOF’s.  (Output) 

[PFJK] 

Partitioning  vector  to  divide  the  f-set  DOFs  that  may  include  GDR  gener¬ 
ated  scalar  points  into  the  original  f-set  DOF’s.  (Output) 

BGPDT(BC) 

GDR  modified  relation  of  basic  grid  point  coordinate  data  which,  on  out¬ 
put,  will  include  the  scalar  points  generated  by  GDR.  (Input  and  Output), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number 

USET{BC) 

GDR  modified  unstructured  entity  defining  structural  sets  which,  on  out¬ 
put,  will  include  the  scalar  points  generated  by  GDR.  (Input  and  Output), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number 
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Application  Calling  Sequence: 

None 

Method: 

The  module  computes  the  partitioning  matrix  PGDR6  to  allow  reduction  of  the  downstream  g-set 
matrices  to  be  only  the  original  g-set  (before  GDR  scalar  points  were  added).  Similarly  the  PFJK 
partitioning  vector  does  the  same  for  f-set  matrices.  The  USET  and  BGPDT  entities  are  updated  to  include 
the  GDR  extra  points  (which  are  assigned  external  id’s  greater  than  any  existing  scalar  points  and 
internal  id’s  greater  than  the  g-size).  These  degrees  of  freedom  will  belong  to  the  k-  and/or  j-sets.  Lastly, 
a  modified  pard  partitioning  vector  is  also  computed  in  which  the  a-set  are  the  generalized  GDR  degrees 
of  freedom  (scalar  points  and/or  physical  DOF)  and  the  r-set  are  the  support  point  DOFs. 

Design  Requirements: 

1.  This  is  the  final  module  in  the  GDR  sequence 
Error  Conditions: 


None 


Engineering  Application  Module:  GDVGRAD 

Entry  Point:  GDVGRD 

Purpose: 

Computes  the  sensitivity  of  design  variable  intrinsic  functions  to  the  changes  of  design  variables. 
MAFOL  Calling  Sequence: 

CALL  GDVGRAD  (  NITER,  NDV,  CONST,  GLBDES  ) ; 

Design  iteration  number  (Integer, Input) 

Number  of  design  variables  (Integer, Input) 

Relation  of  constraint  values  (Character,Input) 

Relation  of  global  design  variables  (Character,Input) 

Application  Calling  Sequence: 

None 

Method: 

This  module  first  determines  the  active  user  functional  constraints  at  the  current  design  iteration.  Then 
the  design  variable  intrinsic  entity  is  searched  to  find  the  design  variable  intrinsic  functions  wMch  are 
required.  The  sensitivities  to  the  design  variables  are  computed  for  those  functions  and  stored  into  the 
design  variable  intrinsic  function  sensitivity  relation  and  matrix  entities. 

Design  Requirements: 

None 

Error  Conditions: 

None 


NITER 

NDV 

CONST 

GLBDES 


171 


Engineering  Application  Module:  GDVRESP 
Entry  Pomt:  6DVRSP 


Purpose: 

Computes  the  design  variable  intrinsic  function  values. 

MAPOL  Calling  Sequence: 

CALL  GDVRESP  (  NITER,  NDV,  GLBDES  ); 

NITER  Design  iteration  number  (Integer, Input) 

NDV  Number  of  design  variables  (Integer, Input) 

GLBDES  Relation  of  global  design  variables  (Character, Input) 

Application  Calling  Sequence: 

None 

Method: 

This  module  searches  through  all  design  variable  intrinsic  entity  entries  and  obtains  aU  design  variable 
identification  numbers  which  are  required  to  evaluate  user  functions.  The  values  of  those  required 
design  variables  are  obtained  from  relation  GLBDES  and  stored  into  the  design  variable  intrinsic 
response  entity. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  GPSP 
Entry  Point:  GPSP 


Pmuose: 


Processes  the  n-set  stiffaess  matrix  to  identify  singularities,  and,  if  requested,  automatically  removes 
them. 


MAPOL  Calling  Sequence: 

CALL  GPSP  (  NITER,  BCID,  NGDR,  IKNN] ,  BGPDT(BC),  [YS(BC)], 
USET(BC),  GPST(BC)  ); 


NITER 

BCID 

NGDR 

[KNN] 

BGPDT{BC) 

[YS(BC)] 

USET(BC) 

GPST{BC) 


Design  iteration  number  (Integer,Input) 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

Denotes  dynamic  reduction  in  the  boundary  condition  (Input,Integer) 

=  0  No  GDR  is  requested 
=  -1  GDR  has  been  requested 

A  partition  of  the  KGG  matrix  which  contains  global  stiffiiess  matrix 
(Character,Input) 

Relation  of  basic  grid  point  coordinates  (Character,Input),  where  BC  repre¬ 
sents  the  MAPOL  boundary  condition  loop  index  munber 

The  vector  of  enforced  displacements  (Character,Input),  where  BC  repre¬ 
sents  the  MAPOL  boundary  condition  loop  index  number 

Unstructured  entity  defining  structural  sets  for  each  degree  of  freedom 
(Character,Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

Unstructured  entity  contains  the  grid  point  singularity  table  information 
(Character,Output),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 


Application  Calling  Sequence: 

None 

Method: 

In  this  module,  for  each  grid  or  scalar  point  the  following  basic  processing  is  done.  For  grid  points  two 
3x3  stiffiiess  matrices  are  processed  and  for  scalar  points  the  single  diagonal  stiffiiess  term  is  processed. 
Each  of  these  is  checked  for  potential  singularities  by  performing  an  eigenvalue  analysis.  If  any 
singularities  are  foimd  and  the  degree  of  freedom  in  question  is  not  in  the  s-set,  m-set  or  connected  to 
an  MPC  equation,  then  a  Single  Point  Constraint  (SPC)  is  generated.  This  module  processes  the  n-set 
matrix  and  will  assure  that  any  singularities  left  are  removed  using  the  same  basic  processing  occurs 
except  only  SPC’s  are  generated  and  RG  is  purged  so  that  no  MPC  connection  processing  occurs. 

Design  Requirements: 

None 

Error  Conditions: 

If  a  non-positive  definite  partition  of  the  stiffiiess  matrix  is  detected  during  AUTOSPC  processing,  or 
if  the  eigenanalysis  fails  to  converge,  the  program  terminates. 
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Engineering  Application  Module :  GPWG 


Entry  Point:  GPWG 


Purpose: 

Grid  point  weight  generator. 

MAPOL  Calling  Sequence: 

CALL  GPWG  (  NITER,  BCID,  GPWGGRID,  [MGG] ,  OGPWG  ); 

NITER  Design  iteration  number  (Optional,  Integer,  Input) 

BCID  User  defined  boundary  condition  identification  number  (Integer,  Input) 

GPWGGRID  Relation  containing  the  data  from  the  GPWG  Bulk  Data  entries  (Input) 

[MGG]  Mass  matrix  in  the  g-set  (Input) 

OGPWG  Relation  of  Grid  Point  Weight  Generation  Output  (Output) 


Application  Calling  Sequence: 

None 

Method: 

The  existence  of  the  MGG  matrix  is  checked  first.  If  it  does  not  exist  or  has  no  columns,  control  is  returned 
to  the  MAPOL  sequence  without  error.  Then  the  CASE  relation  is  read  for  the  current  boundary  condition 
to  determine  if  any  GPWG  print  or  punch  requests  exist.  If  not,  the  module  terminates. 

The  invariant  basic  grid  point  data  are  read  from  bgpdt  and  checked  to  ensure  that  at  least  one  grid 
point  exists.  If  all  the  points  are  scalar  points,  the  module  terminates  without  warning.  Then  the 
CONVERT/MASS  entiy  is  recovered  (if  one  exists)  to  allow  output  of  the  Grid  Point  Weight  from  the  mass 
matrix.  Then  the  coordinates  of  the  reference  point  are  found  from  the  first  gpwg  entry  in  the  GPWGGRID 
relation  or  are  set  to  {0 . 0 , 0 . 0, 0  •  0}. 

The  grid  point  weight  is  then  computed  and  the  results  are  stored  on  the  OGPWG  relation.  If  a  PRINT 
request  exists  for  the  current  design  iteration  or  analyse  boundary  condition,  the  results  are  read  from 
OGPWG  and  printed  to  the  output  file. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  GREDUCE 
Entry  Point:  GREDUC 


Purpose: 

lb  reduce  the  S5annietric  g-set  stif&ess,  mass  or  loads  matrix  to  the  n-set  if  there  are  multipoint 
constraints  in  the  boundary  condition. 

MAFOL  Calling  Sequence: 

f»T.T.  GREDUCE  (  [KGG],  [PG]  ,  IPGMN(BC)],  [TMN(BC)],  [KNN]  ,  [PN]  ); 

Optional  matrix  containing  the  global  stif&iess  or  mass  matrix  to  be  re¬ 
duced  (Input) 

Optional  matrix  containing  the  global  applied  loads  to  be  reduced  (Input) 

The  partitioning  vector  spUtting  the  structural  degrees  of  freedom  into 
the  independent  and  the  multipoint  constraint  degrees  of  freedom  (In¬ 
put),  where  BC  represents  the  MAPOL  boundary  condition  loop  index 
number 

The  transformation  matrix  for  multipoint  constraints  (Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number 

Optional  matrix  containing  the  reduced  KGG  matrix  for  the  independent 
degrees  of  freedom  (Output) 

Optional  matrix  containing  the  reduced  PG  matrix  for  the  independent  de¬ 
grees  of  freedom  (Output) 

Application  Calling  Sequence: 

None 

Method: 

The  GREDUCE  utility  module  performs  the  multipoint  constraint  reduction  on  the  stiffiiess  and/or  mass 
and/or  loads  matrix  based  on  the  presence  or  absence  of  input  arguments.  The  only  required  arguments 
are  the  partitioning  vector  pgmn  and  the  rigid  body  transformation  matrix  TMN.  If  the  KGG  argument  is 
not  omitted,  the  following  operations  are  performed  using  the  large  matrix  utilities: 


^  KGG  j 

KMM  KMN 

KNH  KNN 

[SCRl] 

[KNN]  +  [KNM] [TUN] 

ISCR2] 

= 

[SCRl]  +  [TUN] [KMN] 

[SCRl] 

= 

[KMM]  [TMN] 

[SCR2] 

[SCRl]  +  [TMN] [KMN] 

[KNN] 

[SCR2]  +  [TMN] [KMN] 

These  operations  require  the  creation  of  four  scratch  matrix  entities  for  the  intermediate  resiilts  and 
the  partitions  of  the  KGG  matrix. 


[KGG] 

[PG] 

[PGMNCBC)] 


[TMN(BC) ] 
[KNN] 

[PN] 
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If  the  PG  argument  is  not  omitted,  the  following  operations  are  performed  using  the  large  matrix  utilities: 


[PN]  =  [PN]  +  [TMN]^[PM] 

These  operations  require  the  use  of  two  scratch  matrix  entities  for  the  partitions  of  the  PG  matrix.  When 
both  KGG  and  PG  are  reduced,  the  scratch  partition  matrices  are  shared. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  GTLOAD 
Entry  Point:  GTLOAD 


Purpose: 

Ib  assemble  the  current  static  applied  loads  matrix  for  any  statics  subcases  in  the  current  boundary 
condition. 

MAPOL  Calling  Sequence: 

CALL  GTLOAD  {  NITER,  BCID,  GSIZE,  BGPDT{BC),  GLBDES,  SMPLOD,  [DPTHVI] , 

[DPTHVD],  [DPGRVIl,  [DPGRVD] ,  [PG] ,  OGRIDLOD  ); 

Design  iteration  nximber  (Integer,  Input) 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

The  size  of  the  structural  set  (Integer,  Input) 

Relation  of  basic  grid  point  coordinate  data  (Input),  where  BC  represents 
the  MAPOL  boimdary  condition  loop  index  number 

Relation  of  global  design  variables  (Input) 

Unstructured  entity  of  simple  load  vector  information  (Input) 

Matrix  entity  containing  the  linear  thermal  load  sensitivities  (Input) 

Matrix  entity  containing  the  nonlinearly  designed  thermal  loads 
(Character,  Input) 

Matrix  entity  containing  the  hnear  gravity  load  sensitivities  (Input) 

Matrix  entity  containing  the  nonlinearly  designed  gravity  loads 
(Character,  Input) 

The  matrix  of  apphed  loads  in  the  global  structural  set  (Output) 

Relation  of  loads  on  structural  grid  points.  (Output) 

Application  Calling  Sequence: 

None 

Method: 

The  CASE  relation  tuples  for  the  current  boundary  condition  are  brought  into  memory  to  obtam  the 
mechanical,  thermal  and/or  gravity  simple  load  identification  numbers  for  each  STATICS  discipline. 
The  LOAD  bulk  data  relation  is  also  read  into  memory  to  process  combined  simple  loads  requests.  FinaUy, 
the  SMPLOD  data  are  read  to  determine  the  number  and  types  of  each  simple  load  defined  in  the  bulk 
data  packet.  The  PG  matrix  is  flushed  and  initialized  prior  to  the  start  of  the  loads  assembly  loop.  This 
loop  consists  of  a  search  to  determine  if  the  load  case  is 

(1)  a  simple  mechanical  load 

(2)  a  simple  gravity  load 

(3)  a  simple  thermal  load 

(4)  a  combination  of  mechanical  and/or  gravity  loads 


MITER 

BCID 

GSIZE 

BGPDT(BC) 

GLBDES 
SMPLOD 
t DPTHVI] 
[DPTHVD] 

[DPGRVI] 

[DPGRVD] 

[PG] 

OGRIDLOD 
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The  column  of  the  pg  matrix  associated  with  each  right-hand  side  is  assembled  using  the  SMPLOD  (and 
LOAD)  data.  The  thermal  and  gravity  loads  are  special  in  that  the  glbdes  information  must  be  retrieved 
in  order  to  assemble  the  loads  representing  the  current  design.  The  case  where  no  design  variables  are 
defined  does  not  represent  a  special  case,  however,  since  the  DPVRGI  and  dpthgi  entities  always  include 
terms  representing  the  "zeroth"  design  variable.  Once  all  the  STATICS  cases  have  been  processed,  the 
module  terminates. 

Design  Requirements: 

1 .  The  module  assumes  that  at  least  one  static  load  case  is  defined  in  the  CASE  relation  for  the  current 
boundary  condition. 

2.  The  SMPLOD  entity  from  the  lodgen  module  must  exist  as  must  the  DPVRGi  and  dpthgi  gravity  and 
thermal  load  sensitivity  matrices. 

Error  Conditions: 

1.  No  simple  loads  are  defined  in  the  SMPLOD  entity 
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Engineering  Application  Module;  IFP 


Tb  process  the  Bulk  Data  Pocket  and  to  load  the  input  data  to  the  data  base.  Also,  to  compute  the 
external  coordinate  system  transformation  matrices  and  to  create  the  basic  grid  pomt  data. 

EIDTYPE  ); 

The  size  of  the  structural  set  (Integer,  Output) 

Relation  containing  element  identification  numbers  and  their  correspond¬ 
ing  element  type  (Character, Output) 


^^ication  Calling  Sequence: 


None 


Method: 

The  Input  File  Processor  module  performs  several  tasks  to  initiahze  the  execution  of  ASTROS  procedure. 
It  begins  by  setting  the  titling  information  for  the  IFP  bulk  data  echo  (should  that  option  be  selected). 

Following  these  tasks,  the  module  continues  with  the  interpretation  of  the  bulk  data  packet  of  the  input 
stream  This  packet  resides  on  an  unstructured  entity  called  JcBKDTPKT  which  is  loaded  by  the  executave 
routine  PREPAS  during  the  interpretation  of  the  input  data  stream.  The  IFP  module  proceeds  in  ^o 
phases.  In  the  first  phase,  the  bulk  data  are  read,  expanded  firom  free  to  fixed  format  and  sorted  on  the 
first  three  fields  of  each  bulk  data  entry.  If  an  unsorted  echo  is  requested,  that  echo  is  performed  ^  ^he 
tBKDTPKT  entity  is  read.  If  a  sorted  echo  is  desired,  it  is  performed  after  the  expansion  and  sort  has 
taken  place.  In  either  case,  the  bulk  data  is  sorted  by  the  IFP  module.  The  resultant  data  are  stored  on 
one  or  more  scratch  unstructured  entities  depending  on  how  many  passes  must  be  performed  to 
accomphsh  the  sort  in  the  available  memory.  If  all  the  bulk  data  fits  into  open  core,  only  a  single  scratch 

file  is  required. 

For  the  model  punch  option  request,  the  expanded  and  sorted  input  Bulk  Data  entries  are  divided  into 
following  categories: 

(1)  element  definition  entries  (e.g.  CBAR) 


(2)  property  definition  entries  (e.g.  PBAR) 

(3)  design  variable  linking  and  design  constraint  definition  entries  (e.g.  DESELM,  DESVARP,  DESVARS 
and  DCONVMM,  DCONxxx) 


(4)  the  rest  of  the  Bulk  Data 

Those  entries  in  categories  (1),  (2)  and  (4)  are  stored  in  corresponding  unstructured  entities  for  use  in 
module  DESPUNCH.  Those  in  category  (3)  are  not  saved  for  DESPUNCH,  since  it  will  output  a  MODEL 
without  the  design  entries. 

The  second  phase  of  the  bulk  data  interpretation  proceeds  based  on  the  sorted  bulk  data  fi'om  the 
expansion  phase.  This  phase  begins  by  reading  the  first  bulk  data  entry  in  the  sorted  list  and  locating 
its  bulk  data  template  in  the  set  of  templates  stored  on  the  system  data  base  by  the  SYSGEN  program. 
This  template  defines  the  card  field  labels,  the  field  variable  type,  the  field  default  value,  the  field  error 
checks  and  information  on  where  to  load  the  field  into  the  data  base  loading  array.  The  template  is 


179 


compiled  once  and  all  like  bulk  data  entries  are  processed  together.  Any  user  input  errors  that  are 
detected  are  flagged  with  a  message  indicating  the  field  that  is  in  error  and  whether  the  error  consists 
of  an  illegal  data  t5^e  (i.e,  an  integer  value  in  a  real  field)  or  of  an  illegal  value  for  the  given  field  (i.e., 
a  negative  element  identification  number).  Note  that  the  IFP  module  is  only  checking  errors  on  a  single 
bulk  data  entry  and  does  not  perform  any  inter-entry  compatibility  checks. 

This  process  is  then  repeated  for  each  different  bulk  data  entry  type  in  the  sorted  hst  of  bulk  data  entries. 
If  any  errors  have  occnred,  the  module  terminates  the  ASTROS  execution.  As  a  final  two  steps,  the  IFP 
module  performs  calls  to  the  mktmat,  hkbgpb  and  mkoset  submodules  to  create  the  transformation 
matrices  for  any  external  coordinate  systems,  to  generate  the  basic  grid  point  data  and  to  make  an  error 
checking  pass  over  the  structural  set  definitions.  These  three  tasks  are  not  explicitly  part  of  the  IFP 
module  but  are  so  basic  to  every  execution  that  they  cannot  properly  be  considered  MAPOL  engineering 
application  modules.  Any  errors  resulting  in  these  two  tasks  will  also  cause  the  run  to  terminate  with 
the  appropriate  error  messages. 

Design  Requirements: 

None 

Error  Conditions: 

1.  User  bulk  data  errors  are  flagged  and  cause  program  termination. 

2.  Inconsistent  or  illegal  coordinate  system  definitions. 

3.  Illegal  grid/scalar  and/or  extra  point  definitions. 

4.  Illegal  structioral  set  definitions  in  the  MODEL. 
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Engineering  Application  Module;  INERTIA 

Entry  Point:  INRTIA 

Purpose: 

'I^)  compute  the  rigid  body  accelerations  for  statics  analyses  with  inertia  relief. 

MAPOL  Calling  Sequence: 

CALL  INERTIA  (  [LHS{BC)],  [RHS{BC)],  [AR]  ); 

Rigid  body  reduced  mass  matrix  (Input),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  number 

Applied  load  vector  reduced  to  the  r-set  (Input),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  number 

Matrix  of  acceleration  vectors  (Output) 

Application  Calling  Sequence: 

None 

Method: 

Matrices  LHS  and  RHS  are  read  into  memory  and  AR  is  computed  by  solving  [LHS]  [AR]  =  [RHS] 
Design  Requirements: 

1.  There  must  be  an  r-set  and  the  reductions  to  the  r-set  must  have  been  performed. 

Error  Conditions: 

1.  The  LHS  matrix  is  singular. 


[LHS(BC)] 

[RHS(BC)] 

[AR] 
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Engineering  Application  Module:  ITERINIT 

Entry  Point:  ITINIT 

Purpose: 

Initializes  the  CONST  relation  for  the  current  iteration. 

MAPOL  Calling  Sequence: 

CALL  ITERINIT  {  NITER,  CONST,  LAMBDA  ); 

NITER  Design  iteration  number  (Integer,  Input) 

CONST  Relation  of  design  constraints  (Input  and  Output) 

LAMBDA  Relation  of  extracted  eigenvalues  (Character,  Input  and  Output) 

Application  Calling  Sequence: 

None 

Method: 

This  module  must  be  called  at  the  top  of  each  design  iteration  loop.  Its  function  is  twofold:  1)  to  set  the 
iteration  number  page  header  into  SUBTITLE  (88;)  in  the  /OUTPT2  /  common  and  2)  to  reset  the  CONST 
relation  on  restart  runs. 

Each  page  of  output  during  the  design  iterations  is  labeled  in  the  SUBTITLE  line  with  the  iteration 
number.  It  is  this  modiile  that  sets  that  part  of  the  subtitle  line  that  contains  that  information. 

The  CONST  relation  is  opened  and,  if  not  empty,  a  conditioned  retrieval  is  done  to  see  if  any  entries  exist 
with  an  iteration  number  greater  than  or  equal  to  the  ciuxent  NITER.  If  so,  the  CONST  relation  entries 
with  NITER  values  less  than  the  current  niter  are  copied  to  a  scratch  CONST  relation,  the  scratch  name 
is  exchanged  for  the  old  CONST  name  2ind  the  scratch  entity  (now  pointing  to  the  original  CONST)  is 
destroyed.  Thus,  all  entries  with  NITER  values  associated  with  iterations  that  have  not  yet  occurred  are 
flushed.  This  resetting  of  the  CONST  relation  is  done  so  that  ASTROS  can  be  restarted  at  a  previous 
design  iteration  merely  by  setting  the  value  of  NITER  in  the  MAPOL  sequence  back  to  the  desired 
starting  iteration  number. 

If  CONST  is  empty  or  if  no  restart  actions  are  required,  CONST  is  closed  and  the  module  terminates 
without  action. 

Design  Requirements: 

1.  ITERINIT  is  one  of  the  few  application  modules  that  is  allowed  to  touch  the  title,  subtitle  and 
LABEL  entries  of  the  /OUTPT2  /  common  beyond  the  72nd  character.  While  applications  may  set  the  first 
72  characters  with  the  input  TITLE,  etc.,  generally  only  the  system  may  modify  them  beyond  that.  These 
labels  are  used  by  utpage. 

Error  Conditions: 


None 


Engineering  Application  Module:  LAMINCON 

Entry  Point:  LAMCON 

Purpose: 

Tb  evaluate  composite  laminate  constraints  defined  on  dconiam,  dconlmn  and  dconpmn  bulk  data 
entries. 

MAFOL  Calling  Sequence: 

CALL  LAMINCON  (  NITER,  NDV,  DCONLAM,  DCONLMN,  DCONPMN,  TFIXED,  GLBDES, 

LOCLVAR,  [PTRANS],  CONST  ); 


NITER 

Design  iteration  number  (Integer,  Input) 

NDV 

The  number  of  global  design  variables  (Integer,  Input) 

DCONLAM 

The  relation  containing  the  DCONLAM  entries  (Input) 

DCONLMN 

The  relation  containing  the  dconlmn  entries  (Input) 

DCONPMN 

The  relation  containing  the  dconpmn  entries  (Input) 

TFIXED 

Relation  of  fixed  thicknesses  of  undesigned  layers  of  designed  composite 
elements  (Output) 

GLBDES 

Relation  of  global  design  variables  (Input) 

LOCLVAR 

Relation  contaiaing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Input) 

[PTRANS] 

The  design  variable  linking  matrix  (Input) 

CONST 

Relation  of  constraint  values  (Output) 

Application  Calling  Sequence: 

None 

Method: 

The  LAMINCON  module  begins  by  checking  if  the  DCONxxx  entities  contain  any  entries.  If  there  are  any 
entries,  they  are  considered  to  be  design  constraints  and  are  imposed  (computed).  To  set  up  for  the 
computations,  the  local  design  variable  data,  elemlist  and  plylist  data  are  read  into  memory.  Then 
each  type  of  constraint  is  processed  in  the  order:  ply  minimum  gauge,  laminate  minimum  gauge  and 
laminate  composition.  As  each  constraint  is  computed,  it  is  stored  to  the  CONST  relatioii.  The  TFIXED 
relation  contains  the  thicknesses  of  all  rmdesigned  layers  of  composite  elements  and  is  used  in  the 
evaluation  of  these  constraints  to  determine  the  thicknesses  of  layers  defining  either  the  ply  or  the 
laminate. 

Design  Requirements: 

None 

Error  Conditions: 

1.  Missing  PLYLIST  or  ELEMLIST  data  referenced  on  DCONxxx  entries 

2.  Ply  or  laminate  definitions  that  include  only  undesigned  layers. 
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Engineering  Application  Module:  LAMINSNS 

Entry  Point:  LAMSNS 

Purpose: 

To  evaluate  the  sensitivities  of  composite  laminate  constraints  defined  on  DCONLAM,  DCONLMN  and 
DCONPMN  bulk  data  entries. 

MAPOL  Calling  Sequence: 

CALL  LAMINSNS  (  NITER,  NDV,  GLBDES,  LOCLVAR,  [PTRANS]  ,  CONST,  [AMAT]  )  ; 

Design  iteration  number  (Integer,  Input) 

The  number  of  global  design  variables  (Integer,  Input) 

Relation  of  global  design  variables  (Input) 


NITER 

NDV 

6LBDES 

LOCLVAR 


Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Input) 

The  design  variable  linking  matrix  (Input) 

Relation  of  constraint  values  (Input) 

Matrix  of  constraint  sensitivities  (Output) 


[PTRANS] 

CONST 
[AMAT] 

Application  Calling  Sequence: 

None 

Method: 

The  LAMINSNS  module  begins  by  checking  the  CONST  relation  to  see  if  any  of  the  active  constraints  are 
DCONLAM,  DCONPMN  or  DCONLMN.  These  constraint  types  are  processed  in  this  module  if  any  are  active. 

If  any  active  laminate  constraints  are  present,  their  sensitivities  are  computed  from  the  data  in  the 
CONST  relation  and  the  [PTRANS]  matrix  of  sensitivities.  The  format  of  the  loclvar  and  [PTRANS] 
data  are  such  that,  for  each  row  in  loclvar,  the  corresponding  column  in  [PTRANS]  is  the  sensitivity 
of  the  local  design  variable. 

P-.  _ 

These  are  the  constituents  of  the  derivative  computations.  To  compute  each  of  the  constraint  derivatives, 

dti 

the  appropriate  columns,  — ,  are  summed  and  combined  with  scale  factors  such  as  the  current  thickness 

ov 

and  allowable  value  as  shown  below. 

For  ply  and  laminate  minimum  gauges,  the  constraint  derivative  is  computed  as: 
nply 


where 


train  =  ply  01  laminate  minimum  gauge 

nply  =  munber  of  designed  plies  defining  the  ply  or  laminate 

For  laminate  composition  constraints,  the  constraint  derivatives  are  different  depending  on  whether  an 
upper  or  lower  bound  constraint  is  imposed: 

^tplyi  dtlamj 

tiam  2.  L 
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Lam 


^Slower  __  1 

^am 


npl 
tlam  ^ 
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dv 


npp 

tply  X 
i=l 


^tpfyi 

dv 


where 


tlam  =  current  laminate  thickness 
tply  =  current  piy  thickness 
npp  =  number  oflayers  in  the  current  pZy 
npl  =  number  oflayers  in  the  current  Zcmmctc 
Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  LODGEN 
Entry  Point:  LODGEN 


Purpose: 

To  assemble  the  linearly  designed  simple  load  vectors  and  linear  simple  load  sensitivities  for  all  applied 
loads  in  the  Bulk  Data  packet. 

MAPOL  Calling  Sequence: 

CALL  LODGEN  {  GSIZEB^  GLBDES,  DVCT,  DVSIZE,  GMMCTO,  DMVIO,  TELM,  TREE,  SMPLOD, 
[DPTHVI] ,  [DPGRVI]  ) ; 


GSIZEB 

GLBDES 

DVCT 

DVSIZE 

GMMCTO 

DMVIO 

TELM 

TREE 

SMPLOD 

[DPTHVI] 

[DPGRVI] 


Length  of  the  g-set  vectors  (Integer,  Input) 

Relation  of  global  design  variables  (Input) 

Relation  containing  the  data  required  for  the  assembly  of  the  linear  de¬ 
sign  sensitivity  matrices  (Input) 

Unstructured  entity  containing  memory  allocation  information  on  the 
DVCT  relation  (Input) 

Relation  containing  connectivity  data  for  the  DMVIO  linear  sensitivity  ma¬ 
trix  (Input) 

Unstructured  entity  containing  the  linear  mass  design  sensitivity 

Unstructured  entity  containing  the  linear  design  variable  element  ther¬ 
mal  load  partitions  (Input) 

Unstructured  entity  containing  the  element  reference  temperature  (Input) 
Unstructured  entity  of  simple  load  vector  information  (Output) 

Matrix  entity  containing  the  linear  thermal  load  sensitivities  (Output) 
Matrix  entity  containing  the  linear  gravity  load  sensitivities  (Output) 


Application  Calling  Sequence: 

None 

Method: 

The  module  begins  with  a  call  to  subroutine  LDCHK  which  performs  extensive  error  checking  on  the  bulk 
data  and  solution  control  commands  related  to  apphed  loads  and  performs  bookkeeping  tasks  prior  to 
the  computation  of  the  simple  loads.  Control  is  then  returned  to  LODGEN  and  CSTM  and  BGPDT  data  are 
read  into  core.  A  loop  on  the  niunber  of  unique  external  load  ID’s  is  then  begun.  Calls  to  PCONST  and 
PEOLOW  place  mechanical  loads  bulk  data  information  into  a  GSIZE  loads  vector.  This  vector  is  then 
written  to  the  SMPLOD  imstructured  entity  and  the  process  is  repeated  for  the  remaining  external  loads. 
If  there  are  thermal  loads,  a  caU  to  thrmls/d  creates  columns  of  the  dpthgi  matrix  based  on  linear 
design  element  thermal  matrices  and  temperature  data.  If  there  are  gravity  loads,  a  call  to  gravts/D 
constructs  acceleration  vectors  and  then  computes  dpvrgi  columns  based  on  the  acceleration  vectors 
and  the  DMVI 0  unstructured  entity.  The  DVCT,  TELM  and  TREE  entities  are  purged  and  control  is  returned 
to  the  executive. 
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Design  Requirements: 


1.  For  the  general  case,  this  should  be  the  last  preface  module  because  it  may  require  inputs  from  emg 
and  EMAl. 

Error  Conditions: 

None 


Engineering  Application  Module:  MAKDFU 


Entry  Pomt:  MAKDFU 


Purpose: 

To  assemble  the  sensitivities  to  the  displacements  of  active  stress  and  displacement  constraints  in  the 
current  active  boundary  condition. 

MAPOL  Calling  Sequence: 

CALL  MAKDFU  (  NITER,  BC,  GSIZEB,  [SMAT] ,  [NLSMAT]  ,  SMATCOL,  NLSMTCOL, 

[GLBSIG],  [NLGLBSIG],  CONST,  BGPDT,  [DFDU] ,  ACTUAGG,  SUB  ) ; 


NITER 


Design  iteration  number  (Integer,  Input) 


BC  Boimdary  condition  identification  number  (Integer,  Input) 

GSIZEB  The  size  of  the  structural  set  (Integer,  Input) 


[SMAT] 

[NLSMAT] 

SMATCOL 


Matrix  entity  containing  the  linear  portion  of  the  sensitivity  of  the  stress 
and  strain  components  to  the  global  displacements  (Input) 

Matrix  entity  containing  the  nonlinear  portion  of  the  sensitivity  of  the 
stress  and  strain  components  to  the  global  displacements  (Input) 

Relation  containing  matrix  SMAT  column  information  (Character,Input) 


NLSMTCOL 

[GLBSIG] 

[NLGLBSIG] 

CONST 


Relation  containing  matrix  NLSMAT  column  information 
(Character,Input) 

Matrix  of  stress/strain  components  for  all  the  applied  linearly  designed 
stress  constraints  for  the  current  boundary  condition  (Input) 

Matrix  of  stress/strain  components  for  all  the  apphed  nonlinearly  de¬ 
signed  stress  constraints  for  the  current  boundary  condition  (Input) 

Relation  of  constraint  values  (Input) 


BGPDT (BC) 


Relation  of  basic  grid  point  coordinates  (Character,Input) 


[DFDU]  Matrix  containing  the  sensitivities  of  active  displacement  and/or  stress- 

strain  constraints  to  the  displacements  (Output) 

ACTUAGG  Logical  flag  to  indicate  whether  any  DFDU  terms  exist  (Logical,  Output) 


SUB  An  optional  flag  which  indicates  whether  statics  or  static  aeroelasticity  is 

associated  with  the  constraints  in  this  call.  The  discipline  flag 
=  0  if  STATICS 

=  subscript  identifier,  SUB,  of  the  aeroelastic  subcases  if  saero 
(Integer,  Input) 


Application  Calling  Sequence: 

None 

Method: 

For  the  current  active  boundary  condition,  the  MAKDFU  module  begins  by  processing  the  active 
displacement  constraints.  The  const  relation  is  queried  for  all  active  displacement  constraints 
(CTYPE=3).  Each  tuple  that  qualifies  the  active  condition  is  processed  using  the  PNUM  attribute  to 
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position  to  the  appropriate  location  within  the  dcent  entity.  The  dcent  terms  are  loaded  in  the  dfdu 
matrix  in  the  order  that  active  displacement  constraints  are  encountered  in  the  const  relation. 
Constraints  are  evaluated  for  each  load  condition  within  the  active  boundary  condition  in  constraint 
t3Tpe  order.  The  dfdu  matrix  is  thus  also  formed  in  this  order  but  the  inactive  constraints  are  ignored. 

After  processing  the  active  displacement  constraints  (if  any),  the  makdfu  module  processes  the  active 
stress/strain  constraints.  The  const  relation  is  conditioned  to  retrieve  the  active  stress  and/or  principal 
strain  constraints  (ctype’s  4,  5  and  6).  For  each  active  constraint,  the  cxirrent  boundary  condition 
number  and  the  load  condition  number  (stored  on  the  CONST  relation  in  the  sceval  module)  are  used 
to  determine  the  column  number  of  the  smat  or  nlsmat  matrix  that  holds  the  sensitivity  of  the  current 
stress  term  to  the  displacements.  Having  recovered  the  SMAT  or  NLSMAT  columns  for  the  current  active 
constraint,  the  DFDU  terms  are  computed  based  on  the  element  type  and  constraint  type.  Where  the 
sensitivity  is  a  function  of  the  stress/strain  values,  the  appropriate  rows  of  the  glbsig  or  nlglbsig 
column  associated  with  the  current  boundary  condition/load  condition/discipline  are  retrieved  for  use 
in  the  computations. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module :  MAKDFV 

Entry  Point:  MAKDFV 

Purpose: 

To  assemble  the  sensitivities  of  active  thickness  constraints. 

MAPOL  Calling  Sequence: 

CALL  MAKDFV  (  NITER,  NDV,  [PMINT]  ,  [PMAXT]  ,  CONST,  GLBDES,  DESLINK, 

FDSTEP,  [AMAT]  ) ; 

Design  iteration  number  (Integer,  Input) 

The  number  of  global  design  variables  (Integer,  Input) 

Matrix  entity  containing  the  minimum  thickness  constraint  sensitivities 
(Input) 

Matrix  entity  containing  the  maximum  thickness  constraint  sensitivities 
(Input) 

Relation  of  constraint  values  (Input) 

Relation  of  global  design  variables  (Character,Input) 

Relation  of  design  variable  linking  information  (Character,Input) 

Relative  design  variable  increment  for  finite  difference  (Real,Input) 

The  matrix  of  constraint  sensitivities  to  the  global  design  variables 
(Output) 

Apphcation  Calling  Sequence: 

None 

Method: 

The  MAKDFV  module  begins  by  determining  if  any  active  thickness  constraints  exist  for  this  design 
iteration.  The  CONST  relation  is  conditioned  to  retrieve  active  minimum  and  maximum  thickness 
constraints .  If  any  active  constraints  are  found,  they  are  processed  in  the  order  recovered  from  the  CONST 
relation;  that  is,  active  minimum  thickness  constraints  followed  by  active  maximum  thickness  con¬ 
straints.  Since  the  constraint  sensitivities  are  functions  of  the  current  local  variable  value  when  they 
are  controlled  by  move  limits  rather  than  gauge  hmits,  the  execution  of  the  module  proceeds  with  the 
calculation  of  all  the  individual  layer  thicknesses  for  all  the  elements  designed  by  shape  functions.  Since 
move  limits  are  considered  to  be  desirable  in  the  vast  majority  of  cases  and  because  there  is  no  reliable 
way  to  determine  before-hand  if  any  particular  active  constraint  is  move  limit  controlled,  the  local 
variables  are  always  computed  in  this  module.  The  PTRANS  matrix,  prepared  in  the  makest  modiile  is 
used  to  evaluate  these  thicknesses: 

{t}  =  [PTRANS]  "^{v} 

After  the  local  variables  have  been  computed,  the  LOCLVAR  relation  (also  built  in  the  MAKEST  module) 
is  used  to  determine  the  current  total  thickness  for  a  layered  composite  element.  The  VFIXED  entity 
gives  that  portion  of  the  thickness  of  composite  elements  that  is  not  designed.  The  sensitivities  of  the 
thickness  constraints  are  essentially  the  appropriate  column  of  the  pmint  or  pmaxt  matrix.  The  column 
is  identified  by  the  PNUM  attribute  of  the  CONST  relation.  If  the  particular  local  variable  constraint  is 


NITER 

NDV 

[PMINT] 

[PMAXT] 

CONST 

GLBDES 

DESLINK 

FDSTEP 

[AMAT] 


190 


controlled  by  move  limits,  however,  the  sensitivity  becomes  a  function  of  the  current  thickness  and  must 
be  adjusted  accordingly.  This  applies  only  to  minimum  gauge  constraints,  however,  since  move  limits 
are  not  applied  to  maximum  thickness  constraints.  The  resulting  constraint  sensitivities  are  loaded,  in 
the  order  processed,  onto  the  amat  matrix. 

Design  Requirements: 

1.  The  move  limit  that  is  passed  into  this  routine  must  match  the  value  used  to  evaluate  the  constraints 
in  the  TCEVAL  module.  If  not,  the  constraint  sensitivities  will  be  in  error  with  no  warning  given. 

Error  Conditions: 

1.  The  move  limit  must  be  greater  than  1.0  if  it  is  imposed. 
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Engineering  Application  Module;  MAKDVU 
Entry  Point:  MAKDVU 


Purpose: 

lb  multiply  the  stifihess  or  mass  design  sensitivities  by  the  active  displacements  or  accelerations. 
MAPOL  Calling  Sequence: 

CALL  MAKDVU  (  NITER, 

NITER 
NDV 
GLBDES 
[UGA] 

[DKDG] 

GMKCT 

DKVI 

Application  Calling  Sequence: 

None 
Method: 

This  is  a  utility  module  that  performs  a  matrix  multiplication  of  a  g-set  matrix  of  displacements  or 
accelerations  and  the  g-set  sized  design  sensitivities  DKVI  or  dmvt  entities  that  are  the  NDV  g  x  g  design 
sensitivity  matrices  stored  in  a  highly  compressed  format. 

The  module  first  reads  in  design  variable  information  (ID  and  value)  and  then  space  is  reserved  for  the 
maximum  DKVI  record.  A  determination  is  made  as  to  how  many  columns  of  UGA  and  dkug  can  be  held 
in  core  simultaneously.  Spill  logic  is  used  if  not  all  the  columns  can  be  processed  simultaneously. 
Columns  of  UGA  are  read  into  core  and  a  loop  on  the  number  of  design  variables  is  made  to  calculate  the 
columns  of  the  DKUG  matrix.  Care  is  taken  to  write  null  coliunns  when  a  particular  design  variable  has 
no  DKVT  entries.  The  unmtml  subroutine  is  called  by  makdvu  to  multiply  the  tmstructured  data  and  the 
response  vector. 

Design  Requirements: 

1.  The  format  of  the  DKVI/GMKCT  inputs  is  assumed  to  parallel  the  structure  of  those  entities  output 
from  EMAl. 

Error  Conditions: 

None 


NDV,  GLBDES,  [UGA],  [DKUG],  GMKCT,  DKVI  ) ; 

Design  iteration  number  (Integer,  Input) 

Number  of  design  variables  (Integer,  Input) 

Relation  of  global  design  variables  (Input) 

Matrix  of  "active"  displacements  or  accelerations  for  the  current  bound¬ 
ary  condition  (Input) 

The  product  of  the  design  sensitivity  matrices  and  the  active  displace¬ 
ment/acceleration  vectors  (Output) 

Relation  containing  connectivity  data  for  the  DKVI  sensitivity  matrix 
(Input) 

Unstructured  entity  containing  the  stiEBiess  or  mass  design  sensitivity 
matrix  in  a  highly  compressed  format  (Input) 
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Engineering  Application  Module:  MAKEST 

Entry  Point:  I12^KEST 


Purpose: 

Tb  generate  the  element  summary  entities  for  all  structural  elements.  Also,  to  determine  the  design 
variable  lintring  and  generate  sensitivities  for  any  thickness  constraints. 

MAPOL  Calling  Sequence: 

CALL  MAKEST  (  NDV,  GLBDES,  [PTRANS] /  [FMXMT] ,  [PMAXT] ,  LOCLVAK, 

TFIXED,  DESLINK  ); 


NDV 


The  number  of  global  design  variables  (Integer,  Output) 


GLBDES 


Relation  of  global  design  variables  (Output) 


[PTRANS] 

[PMINT] 

[PMAXT] 

LOCLVAR 

TFIXED 

DESLIMK 


The  design  variable  linking  matrix  (Output) 

Matrix  entity  containing  the  minimum  thickness  constraint  sensitivities 
(Output) 

Matrix  entity  containing  the  maximum  thickness  constraint  sensitivities 
(Output) 

Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Output) 

Relation  of  fixed  thicknesses  of  xmdesigned  layers  of  designed  composite 
elements  (Output) 

Relation  of  design  variable  connectivity  from  makest  module  containing 
one  record  for  each  global  design  variable  connected  to  each  local  vari¬ 
able.  (Output) 


Application  Calling  Sequence: 

None 

Method: 

The  MAKEST  module  performs  the  first  phase  of  the  structural  element  preface  operations  with  the  EMG 
and  MLEMG  module  performing  the  second  phase.  The  first  action  of  the  module  is  to  perform  the 
uniqueness  error  checks  on  the  element  bulk  data  as  stored  on  the  data  base  by  the  IFP  module.  These 
checks  ensure  that  all  property  entries  have  imique  identification  numbers  within  each  property  type 
(with  the  exception  of  the  PCOMPi  entries  where  duplicate  ID’s  signify  different  composite  layers).  Also, 
unique  identification  numbers  for  the  MATi  entries  are  enforced  across  aU  MATi  types.  The  MAKEST 
module  then  performs  the  initial  processing  of  the  design  variable  linking  in  the  PREDES  module,  "^e 
ftT.nnwg  relation  is  set  up  in  memory  with  several  columns  to  be  filled  in  as  the  design  variable  linking 
is  continued  later  in  the  module.  If  there  are  design  variables  defined  in  the  bulk  data,  the  number  of 
global  design  variables,  NDV,  is  determined  for  output  to  the  MAPOL  sequence  and  a  number  of  scratch 
and  hidden  entities  are  opened  to  prepare  for  the  design  variable  linking  task  performed  in  this  module. 

The  MAKEST  module  continues  by  reading  in  the  BGPDT  data  and  initializing  the  PTRANS,  PMINT,  and 
PMAXT  matrix  columns  that  are  built  on  the  fly  in  the  element  dependent  routines.  The  module  then 
rails  each  element  dependent  routine  in  turn.  The  order  in  which  these  submodules  are  called  is  very 
important  in  that  it  provides  an  implicit  order  for  the  MAKEST,  EMG,  NLEMG,  SCEVAL,  EDR  and  OFP 
modules. 
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That  order  is  alphabetical  by  connectivity  bulk  data  entry  and  results  in  the  following  sequence: 

(1)  Bar  elements 

(2)  Scalar  spring  elements 

(3)  Linear  isoparametric  hexahedral  elements 

(4)  Quadratic  isoparametric  hexahedral  elements 

(5)  Cubic  isoparametric  hexahedral  elements 

(6)  Scalar  mass  elements 

(7)  General  concentrated  mass  elements 

(8)  Rigid  body  form  of  the  concentrated  mass  elements 

(9)  Isoparametric  quadrilateral  membrane  elements 

(10)  Quadrilateral  bending  plate  elements 

(11)  Rod  elements 

(12)  Shear  panels 

(13)  Triangular  bending  plate  elements 

(14)  Triangular  membrane  elements 

Within  each  element  dependent  routine,  the  xxxEST  relation  for  the  element  is  opened  and  flushed.  If 
design  variables  exist  in  the  MODEL,  the  ELIST,  PLIST  and  shape  entries  associated  with  this  element 
type  (if  the  element  can  be  designed)  are  opened  and  read  into  memory  for  use  in  the  design  variable 
linking.  Then  the  connectivity  relation  for  the  element  is  opened  and  the  main  processing  loop  begins. 
Each  tuple  is  read,  the  grid  point  references  are  resolved  into  internal  sequence  numbers  and  coordi¬ 
nates,  the  property  entry  is  found  from  the  proper  property  relation(s)  and  the  EST  relation  tuple  is 
formed  in  memory.  Numerous  checks  on  the  existence  of  grid  points,  property  entries  and  the  uniqueness 
of  the  element  identification  number  within  each  element  t^e  are  performed. 

Finally,  if  there  are  design  variables,  the  DESCHK  submodule  is  called  to  determine  whether  the  element 
is  linked  to  a  design  variable.  The  DESCHK  utility  searches  the  in-core  GLBDES,  ELIST,  PLIST  and/or 
SHAPE  data  and  determines  if  the  current  element  is  designed.  Also,  the  final  attributes  of  the  GLBDES 
relation  for  physical  and  shape  function  linking  are  completed.  The  module  performs  error  checks  to 
ensure  that  the  rules  for  design  variable  linking  are  satisfied  for  each  particular  global  design  variable 
and  element. 

On  return  to  the  element  EST  routine,  the  LOCLVAR,  PTRANS,  PMINT  and/or  PMAXT  entities  are  built  for 
the  local  design  variable  if  the  element  was  found  by  DESCHK  to  be  designed.  Finally,  the  constraint 
flags,  design  flags,  design  variable  nonlinear  flag,  composite  type  flag  and  thermal  stress  information 
are  set.  The  constraint  and  thermal  stress  attributes  will  be  revised  as  needed  in  the  EMG  and  NLEMG 
module. 


When  all  the  elements  have  been  processed,  the  EST  relation  for  the  element  type  is  loaded  to  the  data 
base.  Care  is  taken  that  the  final  relation  is  sorted  by  the  element  identification  number.  When  all  the 
element  routines  have  been  called,  the  deslink  entity,  which  was  formed  on  the  fly  in  the  element 
routines,  is  loaded  to  the  data  base.  This  entity  contains  the  number  of  and  identification  numbers  for 
each  design  variable  connected  to  each  designed  element.  These  data  are  used  to  generate  the  DVCT, 
DVCTD  and/or  DDVCT  relations  in  the  EMG  and  NLEMG  module.  All  the  other  design  variable  linking 
entities  that  have  been  built  on  the  fly  are  also  closed.  Any  queued  error  messages  are  dumped  to  the 
user  file  and  the  module  terminates. 


Design  Requirements: 

1.  The  basic  coimectivity  data  firom  the  IFP  module  must  be  available. 


Error  Conditions: 

1,  Numerous  error  checks  are  perfoirmed  on  the  consistency  of  the  bulk  data  for  structural  element 
definition  as  well  as  of  element  geometry  and  connectivity. 

2.  Design  variable  linking  errors  are  flagged. 
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Engineering  Application  Module :  MK2  GG 

Entry  Point:  MK2GG 

Purpose: 


Interprets  case  control  for  the  current  boundary  condition  and  outputs  the  M2GG  and/or  K2GG  matrices 
if  any. 

MAPOL  Calling  Sequence: 

CALL  MK2GG  (  BC^  GSIZEB,  [M2GG] /  M2GGFLAG,  [K2GG] /  K2GGFLAG  ); 

BC  Boundary  condition  identification  number  (Integer,  Input) 

GSIZEB  Number  of  g-set  DOF's  excluding  any  that  may  have  been  added  on  ear¬ 

lier  iterations  by  GDR  (Integer,  Input) 

[M2GG]  Direct  input  g-set  mass  matrix  for  the  current  BC  (Optional,  Output) 

M2GGFLAG  Flag  indicating  whether  M2GG  was  loaded  with  data  (Optional,  Logical, 

Output) 

Direct  input  g-set  stiffiiess  matrix  for  the  cxirrent  BC  (Optional,  Output) 


[K2GG] 

K2GGFI<AG 

Application  Calling  Sequence: 
None 


Flag  indicating  whether  K2GG  was  loaded  with  data  (Optional,  Logical, 
Output) 


Method: 

First  the  case  relation  is  read  for  the  current  boundary  condition  to  determine  if  M2GG  or  K2G6  matrices 
were  named.  Error  checking  is  performed  to  ensure  that  an  output  matrix  is  passed  to  MK2GG  for  both 
matrices  if  both  are  named  in  CASE.  The  arguments  are  otherwise  optional.  Further,  the  entities  named 
in  CASE  are  checked  to  ensure  that  they  are  matrices  and  that  they  are  square  and  of  the  proper  row 
and  column  dimensions  (GSIZEB  x  gsizeb). 

Then  the  named  output  matrix  is  created,  or  if  it  already  exists,  flushed.  The  APPEND  utility  is  used  to 
copy  the  named  entity  onto  the  output  entity. 

Design  Requirements: 

1.  The  DMIG  or  DMI  entries  that  may  be  sources  of  the  M2GG  and/or  K2GG  matrices  must  be  processed 
prior  the  the  calling  of  this  module.  This  module  assumes  that  the  named  entities  already  exist. 

Error  Conditions: 

1.  x2GG  entities  do  not  exist. 

2.  x2GG  entities  are  not  matrix  entities 

3.  x2GG  entities  are  not  of  the  proper  dimension. 

4.  All  errors  cause  ASTROS  termination. 
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Engineering  Application  Module: 

Entry  Point:  MKAMA.T 


MKAKIAT 


Tb  assemble  the  constraint  sensitivity  matrix  from  the  sensitivity  matrices  formed  by  matofu  and  the 
sensitivities  of  the  displacements  for  active  static  load  conditions  in  the  current  active  boundary 
condition. 

MAPOL  Calling  Sequence: 

CALL  MKAMAT  (  [AMAT] ,  [FIRST],  [SECOND],  [THIRD],  PCA,  PRA,  [PGA]  ) ; 

Matrix  of  sensitivities  of  the  constraints  to  the  design  variables 
(Input  and  Output) 

Leading  matrix  in  the  multiplication  to  obtain  AMAT  (Input) 

Trailing  matrix  in  the  multiphcation  to  obtain  AMAT  (Input) 

The  matrix  to  be  added  is  the  multiplication  to  obtain  AMAT  (Input) 

Unstructured  entity  which  contains  the  unique  subcase  numbers  for  the 
constraints  that  are  active  for  the  boundary  condition.  Only  constraints 
for  the  current  boundary  condition  are  included  in  the  list  (Input) 

Unstructured  entity  which  contains  the  unique  subcase  numbers  for  the 
displacement  and/or  element  stress/strain  response  functions  that  are  re¬ 
quired  by  active  \iser  function  constraints  (Character, Input) 

Partition  vector  for  active  displacement  vectors  (Input) 

Application  Calling  Sequence: 

None 

Method: 

Conceptually,  the  module  multiplies  the  transpose  of  the  first  matrix  times  the  SECOND  and  adds  the 
THIRD.  The  data  in  the  three  matrices  are  determined  based  on  whether  the  gradient  method  or  the 
virtual  loads  method  of  sensitivity  analysis  is  being  employed  (see  Subsection  6.3  of  the  Theoretical 
Manual).  The  matrix  multiphcation  is  complicated  by  the  fact  that  it  may  be  necessary  to  partition  the 
matrices  for  each  subcase  that  is  active  in  the  boundary  condition. 

The  module  begins  by  reading  the  PCA  and  PGA  information  into  core.  The  number  and  identity  of  the 
active  subcases  is  determined.  If  the  number  is  greater  than  one,  thirteen  scratch  matrix  ptities  are 
created  to  store  intermediate  data.  A  loop  on  the  number  of  active  subcases  then  occurs.  If  it  is  not  the 
last  pass  through  this  loop,  the  first  matrix  is  partitioned  to  obtain  the  ndv  columns  that  apply  for 
the  current  subcase,  and  the  second  matrix  is  partitioned  to  obtain  only  the  columns  that  correspond 
to  active  constraints  for  the  subcase  and  the  THIRD  matrix  is  partitioned  to  obtain  the  NDV  rows  that 
apply  for  the  current  subcase  and  the  columns  that  correspond  to  active  constraints  for  the  subcase. 

PRA  and  PGA  are  used  to  partition  the  FIRST,  SECOND  and  third  matrices  to  obtain  the  displacement 
and/or  element  stress  and  strain  response  sensitivities  which  are  required  by  active  user  function 
constraints.  Those  sensitivities  are  stored  into  relation  and  matrix  entities  to  be  used  by  user  function 
evaluation  utilities. 


[AMAT] 

[FIRST] 

[SECOND] 

[THIRD] 

PCA 

PRA 

[PGA] 
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The  algorithm  is  somewhat  more  complicated  than  this  in  that  the  parts  of  the  matrices  that  remain 
after  partitioning  are  renamed  to  FIRST  and  SECOND  so  that  the  partitioning  operation  becomes 
successively  smaller  and  no  partition  is  required  on  the  last  pass  through  the  loop.  The  extracted 
matrices  are  then  multiplied  and  the  resulting  matrix  is  either  AMAT  (when  there  is  only  one  active 
subcase  and  the  amat  matrix  was  empty  on  entering  the  module)  or  it  is  appended  to  AMAT.  Once  the 
loop  is  completed,  any  scratch  matrices  are  destroyed  and  control  is  retmmed  to  the  executive. 

Design  Requirements: 

1.  This  module  is  invoked  at  the  end  of  the  boundary  condition  loop  in  the  sensitivity  analysis  portion 
of  the  MAPOL  sequence. 

2.  It  is  called  only  if  there  are  active  stress  and  displacement  constraints  for  the  boimdary  condition. 
Error  Conditions: 

None 
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Engineering  Application  Module:  MKDFDV 
Entry  Point:  MKDFDV 


Purpose: 

Computes  the  sensitivity  of  BAR  element  cross-sectional  dimension  relation  constraints  to  design 
variables 

MAPOL  Calling  Sequence: 

CALL  MKDFDV  (  NITER,  NDV,  CONST,  DESLINK,  GLBDES,  [AMAT]  ); 

Design  iteration  number  (Integer, Input) 

Number  of  design  variables  (Integer, Input) 

Relation  of  constraint  values  (Character, Output) 

Relation  of  design  variable  linking  information  (Character,Input) 

Relation  of  global  design  variables  (Character, Input) 

Matrix  of  sensitivities  of  constraints  to  the  design  variables 
(Character, Output) 

Application  Calling  Sequence: 

None 

Method: 

This  module  first  gets  all  active  BAR  element  cross-sectional  dimension  relation  constraints.  TTie 
sensitivities  of  each  active  constraint  to  the  design  variables  are  computed  by  multiplying  the  sensitivi¬ 
ties  of  the  constraint  to  the  dimensions  (factors  in  relation  const)  with  the  sensitivities  of  the 
dimensions  to  the  design  variables  (PREF  in  DESLINK).  Those  sensitivities  are  then  stored  in  columns 
of  matrix  [AMAT] . 

Design  Requirements: 

None 

Error  Conditions: 


NITER 

NDV 

CONST 

DESLINK 

GLBDES 

[AMAT] 


None 


Engineering  Application  Module:  mkdfsv 


MKDFSV 


lb  calcxilate  matrix  [DFSV]  which  contains  the  S-matrix  derivatives  related  to  active  stres^strain 
constraints.  The  stress/strain  constraints  are  functions  of  the  product  of  the  S-matrix  and  the  displace¬ 


ments: 


8  =  f  (Su) 

The  sensitivities  of  these  constraints  to  the  designed  variables  is  decomposed  into  two  parts.  The  first 
is  a  function  of  the  product  of  the  S-matrix  derivatives  and  displacements,  and  the  second  is  a  function 
of  the  product  of  the  S-matrix  and  the  displacement  derivatives: 


+  h\S 


dv  '  dv 


The  DFSV  matrix  represents  the  first  part: 


DFSV  =  f 


MAPOL  Calling  Sequence: 

CALL  MKDFSV  (  NITER,  BC,  GSIZEB,  [NLGLBSIG] ,  CONST,  [NLSMAT] ,  NLSMTCOL, 
[UGA],  DESLINK, DSCFLG,  NDV,  GLBDES,  LOCLVAR,  [PTRANS] , 
[DFSV],  DELTA  ); 


NITER 


GSIZEB 


[NLGLBSIG] 


CONST 


[NLSMAT] 


NLSMTCOL 


[UGA] 


DESLINK 


DSCFLG 


GLBDES 


Optimization  iteration  number  (Integer,  Input) 

The  MAPOL  boxmdary  condition  loop  index  number  (Integer,  Input) 

number  of  dofs  in  the  structural  set  (Integer,  Input) 

Stress  vectors  for  design  variable  nonlinearly  constrained  elements 
(Character,  Input) 

Relation  of  constraints  (Character,  Input) 

Matrix  entity  containing  the  nonlinear  portion  of  the  sensitivity  of  the 
stress  and  strain  components  to  the  global  displacements 
(Character, Input) 

Relation  containing  matrix  NLSMAT  column  information 
(Character, Input) 

Active  displacement  vectors  at  current  boundary  condition 
(Character,  Input) 

Relation  of  design  variable  linking 

Discipline  flag  (Integer,  Input) 

=  0  statics 

^  0  static  aeroelasticity 

Number  of  design  variables  (Integer,  Input) 

Global  design  variable  relation  (Character,  Input) 
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Local  design  variable  relation  (Character,  Input) 

Design  variable  linking  matrix  (Character,  Input) 

Matrix  contains  S-matrix  derivatives  related  active  stress/strain  con¬ 
straints  (Character,  Output) 

The  relative  design  variable  increment  for  finite  difference  computation. 
(Real,  Input) 

Application  Calling  Sequence: 

None 

Method: 

This  module  first  gets  the  DVID  list  from  glbdes.  The  module  then  gets  EST  entries  for  nonline^ly 
designed  constraint  QUAD4  and  TRIA3  elements  and  places  them  into  incore  lists.  Then  the  module 
determines  the  number  of  active  displacement  constraints,  and  gets  active  stress  and  strain  constraints 
for  this  design  iteration.  Null  columns  are  stored  in  DFSV  corresponding  to  active  displacement 
constraints  so  that  DFSV  will  be  compatible  in  module  MKAMAT.  For  each  active  stress/strain  constraint, 
the  following  operations  are  applied.  If  it  is  a  linearly  designed  constraint,  a  null  column  is  stored  in 
DFSV  otherwise,  matrix  DSDT  which  contains  the  sensitivities  of  the  nonlinear  S-matrix  to  the  related 
local  design  variables  is  computed  for  the  element  related  to  this  constraint.  Matrix  DSDV  which  contains 
the  sensitivities  of  the  nonlinear  S-matrix  to  the  related  global  design  variables  is  computed  by  usmg 
the  DSDT  matrix  and  design  variable  linking  factors  from  DESLINK.  Matrix  DSVU  is  the  multiplication 
of  the  transposed  active  displacement  vector  uga  times  dsdv.  The  DFSV  term  at  the  row  number 
corresponding  to  that  active  constraint  is  computed  from  DSVU,  the  constraint  value,  the  related 
stress/strain  values  from  nlglbsig,  and  the  constraint  allowables. 

Design  Requirements: 

1 .  This  module  must  be  called  prior  to  mkamat  and  after  the  active  displacement  vector  is  available. 

Error  Conditions: 

None 


LOCLVAR 

[FTRANS] 

[DFSV] 

DELTA 
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Engineering  Application  Module :  MKP VECT 


Entry  Point:  PVCDRV 


Purpose: 

To  generate  partitioning  vectors  from  imstructured  entity  USET. 

MAPOL  Calling  Sequence: 

CALL  MKPVECT  (  USET(BC),  [PGMN(BC)],  [PNSF(BC)],  [PFOA(BC)],  [PARL(BC)]  ); 


USET(BC) 


[PGMN(BC}] 


[PNSF(BC)] 

[PFOA(BC)] 

[PARL(BC)] 


Unstructured  entity  defining  structural  sets  for  each  degree  of  freedom 
(Character, Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

The  vector  partitioning  the  structural  degrees  of  freedom  into  the  inde¬ 
pendent  and  the  multipoint  constraint  degrees  of  freedom 
(Character,  Output),  where  BC  represents  the  MAPOL  boundary  condi¬ 
tion  loop  index  number 

The  vector  partitioning  the  independent  degrees  of  freedom  into  the  free 
and  the  single  point  constraint  degrees  of  freedom  (Character,  Output), 
where  BC  represents  the  MAPOL  boxmdary  condition  loop  index  ntimber 

The  vector  partitioning  the  free  degrees  of  freedom  into  the  analysis  set 
and  the  omitted  degrees  of  freedom  (Character,  Output),  where  BC  repre¬ 
sents  the  MAPOL  boundary  condition  loop  index  number 

The  vector  partitioning  the  analysis  set  degrees  of  freedom  into  the  1-set 
and  the  support  degrees  of  freedom  (Character,  Output),  where  BC  repre¬ 
sents  the  MAPOL  boundary  condition  loop  index  number 


Application  Calling  Sequence: 

CALL  PVCDRV  (  USET,  PGMN,  PNSF,  PFOA,  PARL  ) 


Method: 

This  module  first  reads  the  USET  record  which  contains  the  number  of  degrees  of  freedom  in  each 
dependent  set  and  the  bit  masks  defining  the  structural  sets  to  which  the  degrees  of  freedom  belong 
Then,  for  each  requested  partitioning  vector,  the  bit  masks  in  USET  are  checked  for  all  degrees  of  freedom 
with  the  related  structural  sets,  and  then  the  vector  is  generated. 

Design  requirements: 

Any  of  the  partitioning  vector  names  may  be  blank  if  the  corresponding  partition  will  not  be  used 
subsequently. 


Error: 

None 
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Engineering  Application  Module;  MKUSET 
Entry  Point:  MKUSET 


Purpose: 

lb  generate  the  structural  set  definition  entity,  USET,  for  each  boimd^  condition  and  to  form  the 
partitioning  vectors  and  transformation  matrices  used  in  matrix  reduction. 


MAPOL  Calling  Sequence: 

raT.T.  MKUSET  (  BCID,  GSIZEB,  [YS]  ,  [TMN] ,  [PGMN]  ,  [PNSF] ,  [PFOA]  , 
[PARL],  USET  ); 


BCID 


User  defined  boundary  condition  identification  number  (Integer,  Input) 


GSIZEB 


The  size  of  the  structural  set  (Integer,  Input) 


[ys{BC)] 

[TMN(BC)] 

[PGMN(BC)] 

tPNSF(BC)] 
[PFOA(BC)] 
[PARIi(BC)  ] 
USET(BC) 


The  vector  of  enforced  displacements  (Output) 

The  transformation  matrix  for  multipoint  constraints  (Output) 

The  partitioning  vector  splitting  the  structural  degrees  of  freedom  into 
the  independent  and  the  multipoint  constraint  degrees  of  freedom 
(Output) 

The  partitioning  vector  splitting  the  independent  degrees  of  fireedom  into 
the  fi-ee  and  the  single  point  constraint  degrees  of  freedom  (Output) 

The  partitioning  vector  splitting  the  free  degrees  of  freedom  into  the 
analysis  set  and  the  omitted  degrees  of  freedom  (Output) 

The  partitioning  vector  sphttmg  the  analysis  set  degrees  of  fireedom  into 
the  1-set  and  the  support  degrees  of  freedom  (Output) 

The  imstructured  entity  defining  structural  sets  (Output) 


Application  Calling  Sequence: 

None 

Method: 

The  MKUSET  module  performs  four  tasks.  The  first  is  to  build  the  USET  entity  of  structural  set  definition 
masks  for  the  input  boundary  condition.  At  the  same  time,  the  rigid  constraint  matrix,  TMM,  relating 
the  dependent  multipoint  constraint  degrees  of  freedom  to  the  independent  degrees  of  freedom  is  foimed. 
Also,  the  vectors  of  enforced  displacements  for  single  point  constraints  are  formed.  Lastly,  the  partition¬ 
ing  vectors  for  the  structural  sets  are  formed. 

The  generation  of  boundary  condition  dependent  subscripted  matrix  entities  requires  that  the  MKUSET 
module  be  called  once  for  each  botmdary  condition  in  the  Solution  Control  packet.  The  looping  logic  is 
contained  in  the  standard  executive  sequence  rather  than  within  the  module  itself.  Each  structural 
degree  of  freedom  (DOF)  is  assigned  a  word  in  each  record  of  the  USET  entity  (aerodynamic  degrees  of 
freedom  and  extra  points  are  ignored).  One  record  is  created  for  each  boundary  condition  in  the  Solution 
Control  packet.  The  MKUSET  module  determines  to  which  sets  a  structural  DOF  belongs  and  sets  the 
corresponding  bits  in  the  USET  word  associated  with  that  degree  of  freedom.  That  word  is  the  bitmask 
for  that  degree  of  freedom. 
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The  assignment  of  a  bit  position  for  each  structural  set  is  defined  as  shown  below  and  are  stored  in  the 
/BITPOS/  common  block: 


SET 

BIT 

POSITION 

DESCRIPTION 

ux 

16 

UJJP 

17 

Used  for  d5niamic  reduction 

UJJ 

18 

UKK 

19 

USB 

20 

Single  point  constraints  (SPC) 

USG 

21 

Permanent  SPCs 

UL 

22 

Free  points  left  for  solution 

UA 

23 

Analysis  set 

UP 

24 

Free  degrees  of  freedom 

UN 

25 

Independent  degrees  of  freedom 

U6 

26 

Dependent  degrees  of  freedom 

UR 

27 

Support  set  DOF 

UO 

28 

Omitted  (Guyan  Reduction)  DOF 

US 

29 

Unions  of  USB  and  USG  sets 

30 

^  Dependent  MPC  DOF 

The  MKUSET  module  begins  by  preparing  memory  blocks  for  use  by  the  module  subroutines.  The  BGPDT 
tuples  associated  with  structural  nodes  are  brought  into  core  for  use  in  conversion  of  external 
identification  numbers  to  internal  identification  numbers.  Each  separate  structural  set  is  processed  by 
an  individual  submodule  of  MKUSET  with  the  defaulting  for  unspecified  DOF  taking  place  in  the  module 
driver.  The  CASE  relation  is  read  to  determine  the  boundary  condition  definition  for  the  current  boimdary 
condition.  The  submodule  UMSET,  responsible  for  multipoint  constraint  set  definition  also  build  the  TMN 
matrix  while  the  USSET  submodule  for  single  point  constraints  builds  the  YS  vector.  After  the  USET 
masks  have  been  built  for  the  boundary  condition,  extensive  error  checking  occurs  to  ensure  that  each 
point  is  placed  in  no  more  than  one  dependent  structural  set.  If  no  errors  have  occured,  the  usET  record 
is  written  and  the  associated  partitionmg  vectors  are  formed. 

Design  Requirements: 

1.  The  MKUSET  module  requires  that  the  case  relation  be  complete  from  the  solution  module  and  that 
the  BGPDT  be  formed  either  by  the  BCBGPDT  or  IFP  modules  prior  to  execution. 

Error  Conditions: 

1.  Any  inconsistent  boundary  condition  specifications  are  flagged. 

2.  Any  missing  bulk  data  referenced  by  Solution  Control  is  flagged. 
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Engineering  Application  Module: 

Entry  Point:  MWRESP 


MSWGRESP 


Purpose: 

Computes  element  mass  and/or  weight  intrinsic  responses. 

MAPOL  Calling  Sequence: 

CALL  MSWGRESP  (  NITER,  GLBDES,  DESLINK  ); 

Design  iteration  number  (Integer, Input) 

Relation  of  global  design  variables  (Character, Input) 

Relation  of  design  variable  linking  information  (Character,Input) 

Application  Calling  Sequence: 

None 

Method: 

This  module  search  through  all  element  weight  and  mass  intrinsic  entity  entries  and  obtains  all  element 
identification  numbers  which  are  required  by  user  function  instances.  The  values  of  those  required 
element  weight  and/or  mass  are  obtained  from  relation  elhass  which  are  generated  in  module 
EMG/NLEMG  and  stored  into  element  weight  and/or  mass  intrinsic  response  entity  vdth  instance 
information. 

Design  Requirements: 

None 

Error  Conditions: 

None 


NITER 

GLBDES 

DESLINK 
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Engineering  Application  Module: 


NLEMAl 


Entry  Point:  NLEMAl 


Purpose: 

lb  assemble  the  nonlinearly  designed  element  stiffiiess  and  mass  sensitivity  matrix  partitions  (stored 
in  DKELM  and  DMELM  entities)  with  linear  stiffness  and  mass  sensitivity  matrix  partitions  (  dkviO  and 
DMVIO  )  into  the  design  sensitivity  matrices  DKVI  and  dmvi.  To  assemble  the  nonlinear  design  stiffiiess 
and  mass  matrix  partitions  (  kelmd  and  MELMD  )  with  entities  DKVlO  and  DMViO  into  the  stiffiiess  and 
mass  matrices  DKVIG  and  dmvig  for  global  stiffiiess  and  mass  matrix  assembling. 

MAPOL  Calling  Sequence: 

CALL  NLEMAl  (  NITER,  NDV,  GLBDES,  DVCTD,  DDVCT,  KELMD,  DKELM,  MELMD,  DMELM, 
GMKCTO,  DKVIO,  GMMCTO,  DMVIO,  DWGHl,  GMKCT,  DKVI,  GMMCT, 

DMVI,  GMKCTG,  DKVTG,  GMMCTG,  DMVIG,  GMMCTD,  DMVID,  DGMMCT, 

DDMVI,  DDWGH2  ); 


NITER  Optimization  iteration  number  (Integer,  Input) 

NDV  Number  of  design  variables  (Integer,  Input) 

GLBDES  Relation  of  globad  design  variables  (Character,  Input) 


DCVTD 

DDVCT 

KELMD 

DKELM 

MELMD 

DMELM 

GMKCTO 

DKVIO 

GMMCTO 

DMVIO 

DWGHl 

GMKCT 


Relation  containing  the  data  required  for  the  assembly  of  the  nonlinear 
design  stiffiiess  and  mass  matrices  (Character,  Input) 

Relation  containing  the  data  required  for  the  assembly  of  the  nonlinear 
design  sensitivity  matrices  (Character,  Input) 

Unstructured  entity  containing  the  nonlinear  design  stiffiiess  matrix  par¬ 
titions  (Character,  Input) 

Unstructured  entity  containing  the  nonlinear  stiffiiess  sensitivity  matrix 
partitions  (Character,  Input) 

Unstructured  entity  containing  the  nonlinear  design  mass  matrix  parti¬ 
tions  (Character,  Input) 

Unstructured  entity  containing  the  nonlinear  mass  sensitivity  matrix  par¬ 
titions  (Character,  Input) 

Relation  containing  connectivity  data  for  the  dkyio  linear  sensitivity  ma¬ 
trix  (Character,  Input) 

Unstructured  entity  containing  the  linear  stiffiiess  sensitivity  matrix  in  a 
highly  compressed  format  (Character,  Input) 

Relation  containing  connectivity  data  for  the  DMVIO  linear  sensitivity  ma¬ 
trix  (Character,  Input) 

Unstructured  entity  containing  the  linear  mass  sensitivity  matrix  in  a 
highly  compressed  format  (Character,  Input) 

Unstructured  entity  containing  the  Unear  (invariant)  portion  of  the  sensi¬ 
tivity  of  weight  to  the  design  variables  (Character,  Input) 

Relation  containing  connectivity  data  for  the  DKVI  sensitivity  matrix 
(Character,  Output) 
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DKVI 

Unstructured  entity  containing  the  total  stiffness  design  sensitivity  ma¬ 
trix  in  a  highly  compressed  format  (Character,  Output) 

GMMCT 

Relation  containing  connectivity  data  for  the  DMVI  sensitivity  matrix 
(Character,  Output) 

DMVI 

Unstructured  entity  containing  the  total  mass  design  sensitivity  matrix 
in  a  highly  compressed  format  (Character,  Output) 

GMKCTG 

Relation  containing  connectivity  data  for  the  DKViG  stiffness  matrix 
(Character,  Output) 

DKVIG 

Unstructured  entity  containing  the  stiffriess  matrix  in  a  highly  com¬ 
pressed  format  (Character,  Output) 

GMMCTG 

Relation  containing  connectivity  data  for  the  DMViG  mass  matrix  (Charac¬ 
ter,  Output) 

DMVIG 

Unstructured  entity  containing  the  mass  matrix  in  a  highly  compressed 
format  (Character,  Output) 

GMMCTD 

Relation  containing  connectivity  data  for  the  DMVID  mass  matrix  (Charac¬ 
ter,  Output) 

DMVID 

Unstructured  entity  containing  the  nonlinear  part  of  mass  matrix  in  a 
highly  compressed  format  (Character, Output) 

DGMMCT 

Relation  containing  connectivity  data  for  the  DDMVI  nonlinear  mass  sensi¬ 
tivity  matrix  (Character,  Output) 

DDMVI 

Unstructured  entity  containing  the  nonlinearly  designed  mass  sensitivity 
matrix  in  a  highly  compressed  format  (Character,  Output) 

DDWGH2 

Unstructured  entity  containing  the  nonlinear  portion  of  the  sensitivity  of 
weight  to  the  design  variables  (Character,  Output) 

Application  Calling  Sequence: 

None 

Method: 

The  module  is  executed  in  two  passes;  once  for  nonlinear  design  stif&iess  matrices  and  nonlinear 
stiffness  sensitivity  matrices,  and  a  second  time  for  nonlinear  design  mass  matrices  and  nonlinear  mass 
sensitivity  matrices. 

In  the  first  pass,  DVCTD  information  is  read  into  core  one  record  at  a  time.  The  algorithm  is  structured 
to  maximize  the  amoimt  of  processmg  done  on  a  given  design  matrix(typically  all  of  it)  in  core.  Spill 
logic  is  in  place  if  a  matrix  cannot  be  completely  held  in  core.  For  the  assembly,  subroutine  nlrqcr 
performs  bookkeeping  tasks  to  expedite  the  assembly  and  to  determine  whether  spill  will  be  necessary. 
Subroutine  NIASMl  retrieves  kelmd  information,  performs  the  actual  assembly  operations  and  place 
the  results  into  the  gmkctsdkvi,  and  results  in  dgmkct  and  ddkvi  entities. 

If  a  discipline  which  requires  a  mass  matrix  is  included  in  the  solution  control,  the  mass  terms  are 
assembled  in  the  second  pass.  If  there  are  optimize  boundary  conditions,  this  module  calculates  the 
nonlinear  portion  of  the  sensitivity  of  the  weight  to  the  design  variables  (DDWGH2)  and  the  nonlinear 
portion  of  the  weight  (DWGH2)  regardless  of  whether  the  mass  matrices  are  required.  If  no  mass 
information  is  required,  the  second  pass  is  not  made.  For  the  second  pass,  melmd  and  dmelm  data  are 
used.  The  structure  of  the  assembly  operation  is  otherwise  much  the  same  and  GMMCYD,  DGMMCY,  DMVTD 
and  DDMVI  data  are  computed  and  stored.  After  those  two  passes,  the  total  weight  is  computed  from 
DWGHl  and  DWGH2.  GMKCTO,  DKVIO,  DGMKCT,  DDKVI  are  merged  into  stiffriess  sensitivity  entities  gmkct 
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and  DKVl;  gmmcto,  dmvio,  ddgmmcy,  ddhvi  are  merged  into  mass  sensitivity  entities  gmmct  and  dmvi; 
GMKCTO,  DKVIO,  GMMCYD,  DKVID  are  merged  into  stifBiess  matrix  entities  GMKCTG  and  DKVIG;  GMMCTO, 
DMVIO,  GMMCYD,  DMVID  are  merged  into  mass  matrix  entities  gmmctg  and  DMVIG. 

Design  Requirements: 

1.  This  assembly  operation  follows  NLEMG  within  the  MAPOL  OPTIMIZE  iterations. 

2.  Since  gravity  loads  require  DMVID  and  DDMVI  data,  it  is  necessary  to  perform  NLEMAl  prior  to 
calling  NLLODGEN.  NLEMAl  must  always  be  called  before  EMA2. 

Error  Conditions: 

None. 
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Engineering  Application  Module; 

Entry  Point:  NLEM6 


NLEMG 


Purpose: 

lb  compute  the  nonlinear  design  stif&ess,  mass,  thermal  load  and  stress  component  sensitivities  and 
nonlinear  design  stiffness  and  mass  matrix  partitions. 

MAPOL  Calling  Sequence: 

np,j.T.  NIiEMG  {  NITER,  NDV,  GSIZEB,  GLBDES,  LOCLVAR,  [PTRANS]  ,  DESLINK, 
tNLSMAT],  NLSTMCOL,  DVCTD,  DDVCT,  DVSIZED,  DDVSIZE, 

KEIiND,  DKELM,  HELMD,  DNELM,  TELMD,  DTEIjN,  TREFD,  FDSTEP  )  ; 


NITER 

Optimization  iteration  number  (Integer,  Input) 

NDV 

Number  of  design  variables  (Integer,  Input) 

GSIZEB 

The  size  of  the  structural  set  (Integer,  Input) 

GLBDES 

Relation  of  global  design  variables  (Character,  Input) 

LOCLVAR 

Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem.  (Character,  Input) 

[PTRANS] 

The  design  variable  linking  matrix  (Character,  Input) 

DESLINK 

Relation  of  design  variable  connectivity  from  MAKEST  module 
(Character,  Input) 

[NLSNAT] 

Matrix  entity  containing  the  nonlinear  portion  of  the  sensitivity  of  the 
stress  and  strain  components  to  the  global  displacements.  (Output) 

NLSMTCOL 

Relation  containing  matrix  NLSMAT  column  information 
(Character,Output) 

DCVTD 

Relation  containing  the  data  required  for  the  assembly  of  the  nonlinearly 
designed  stiffness  and  mass  matrices  (Character,  Output) 

DDVCT 

Relation  containing  the  data  required  for  the  assembly  of  the  nonlinearly 
designed  sensitivity  matrices  (Character,  Output) 

DVSIZED 

Unstructured  entity  containing  memory  allocation  information 
on  the  DVCTD  relation.  (Character,  Output) 

DDVSIZE 

Unstructured  entity  containing  memory  allocation  information  on  the 
DDVCT  relation.  (Character,  Output) 

KELMD 

Unstructured  entity  containing  the  nonlinearly  designed  stif&iess  matrix 
partitions  (Character,  Output) 

DKELM 

Unstructured  entity  containing  the  nonlinear  stiffiiess  sensitivity  matrix 
partitions  (Character,  Output) 

Unstructured  entity  containing  the  nonlinearly  designed  mass  matrix 
partitions  (Character,  Output) 

DMELM 

Unstructured  entity  containing  the  nonlinear  mass  sensitivity  matrix  par¬ 
titions  (Character,  Output) 
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TELMD 

DTELM 

TREFD 

FDSTEP 

Application  Calling  Sequence: 

None 

Method: 

The  NLEMG  module  performs  the  nonlinear  design  variable  part  of  the  second  phase  of  the  structural 
element  preface  operations  with  the  MAKEST  modxile  performing  the  first  phase. The  first  action  of  the 
NLEMG  module  is  to  determine  if  nonlinear  design  variables  and/or  thermal  loads  are  defined  in  the  bulk 
data.  If  they  are,  the  special  actions  for  design  variable  linking  and  thermal  stress  corrections  are  taken 
in  the  element  dependent  routines.  The  PREMAT  utility  to  set  up  the  material  property  data  also  returns 
the  SCON  logical  flag  to  denote  that  there  are  stress  constraints  defined  in  the  bulk  data.  The 
initiahzation  of  the  module  continues  with  the  retrieval  of  the  MFORM  data  to  select  lumped  or  coupled 
mass  matrices  in  the  elements  that  support  both  forms.  The  default  is  lumped  although  any 
MFORM/COUPLED  (even  if  MFORM/LUMPED  also  exists  )  will  cause  the  coupled  form  to  be  used.  If  thermal 
loads  exist,  the  module  prepares  the  TREFD  entity  to  be  written  by  the  element  dependent  routines.  The 
GLBDES  relation  is  opened  and  the  design  variable  identification  numbers  are  read  into  memory.  Finally, 
the  DDVCT  and  DVCTD  entities  are  opened  and  flushed  and  memory  is  retrieved  to  be  used  in  the  NLDVCT 
submodule  to  load  the  DDVCT  and  DVCTD  relations.  The  order  in  which  these  submodules  are  called  is 
alphabetical  by  connectivity  bulk  data  entry,  i.e.,  (1)  Bar  elements,  (2)  Quadrilateral  bending  plate 
elements,  and  (3)  Triangular  bending  plate  elements. 

Within  each  element  dependent  routine,  the  aoacEST  relation  for  the  element  is  opened  and  read  one  tuple 
at  a  time.  If  the  est  relation  indicates  that  the  element  is  nonlinearly  designed,  the  deslink  data  is  used 
to  write  one  set  of  tuples  to  the  DDVCT  and  DVCTD  relations  for  each  unique  design  variable  linked  to  the 
element.  The  set  of  tuples  consists  of  one  row  for  each  node  to  which  the  element  is  connected.  The  element 
dependent  geometry  processor  is  then  called  to  generate  the  DKELM,  KELMD,  DiffiLM,  MELMD,  DTEM  and 
TELMD  entries  for  the  element.  These  data  must  be  generated  before  the  next  caU  to  NLDVCT  since  the  DDVCT 
and  DVCTD  form  the  directory  to  all  these  entities.  Once  aU  the  elements  are  processed  within  the  current 
element  dependent  routine,  the  TREFD  entity  is  appended  with  the  vector  of  reference  temperatures  for  the 
current  set  of  elements.  Again,  the  order  of  these  reference  temperatures  are  determined  by  the  sequence 
listed  above  and  is  assumed  to  hold  in  other  modules.  When  aU  the  element  dependent  drivers  have  been 
called  by  the  NLEMG  module  driver,  clean  up  operations  begin.  The  entities  that  have  been  open  for  writing 
by  the  element  routines  are  closed,  the  remaining  in-core  DDVCT  and  DVCTD  tuples  are  written  to  the  data 
base  and  the  relations  are  sorted.  If  there  are  no  design  variables  (all  DVTD’s  are  zero),  the  DVCT  is  sorted 
only  on  KSIL.  Finally,  if  stress  or  strain  constraints  were  defined  in  the  bxilk  data  stream,  the  nlsmat  matrix 
of  constraint  sensitivities  to  the  displacements  is  closed.  NLSMAT  was  opened  by  the  PREMAT  modide  when 
the  SCON  constraint  flag  was  set. 

Design  Requirements: 

1.  The  MAKEST  module  must  have  been  called  prior  to  the  NLEMG  module. 

Error  Conditions: 


Unstructured  entity  containing  the  nonlinearly  designed  thermal  load 
partitions  (Character,  Output) 

Unstructured  entity  containing  the  nonlinear  thermal  load  sensitivity  ma¬ 
trix  partitions  (Character,  Output) 

Unstructured  entity  containing  the  element  reference  temperatures  for 
nonlinearly  designed  thermal  loads.  (Character,  Output) 

Relative  design  variable  increment  for  finite  difference  (Real,  Input) 


1.  Illegal  element  geometries  and  nonexistent  material  properties  are  flagged. 


Engineering  Application  Module;  NLLODGEN 
Entry  Point:  NLLDGN 


Purpose: 

lb  assemble  the  nonlinear  design  variable  simple  load  vectors  and  nonlinear  simple  load  sensitivities 
for  all  applied  loads  in  the  Bulk  Data  packet. 


MAPOL  Calling  Sequence: 

CAliL  NLLODGEN  (  GSIZEB,  GLBDES,  DVCTD,  DDVCT,  DVSIZED,  DDVSIZE,GMMCTD, 

DGMMCT,  DMVID,  DDMVI,  TELMD,  DTELM,  TREED,  [DPTHVD] , [DDPTHV] , 
[DPGRVD] ,  [DDPGRV]  ) ; 


GSIZEB 

GLBDES 

DCVTD 

DDVCT 

DVSIZED 

DDVSIZE 

GMMCTD 

DGMMCT 

DMVID 

DDMVI 

TELMD 

DTELM 

TREFD 

[DPTHVD] 

[DDPTHV] 

[DPGRVD] 


The  size  of  the  structural  set  (Integer,  Input) 

Relation  of  global  design  variables  (Character,  Input) 

Relation  containing  the  data  required  for  the  assembly  of  the  nonlinearly 
designed  stiffiiess  and  mass  matrices  (Character,  Input) 

Relation  containing  the  data  required  for  the  assembly  of  the 
nonlinearly  designed  sensitivity  matrices  (Character,  Input) 

Unstructiired  entity  containing  memory  allocation  information 
on  the  DVCTD  relation.  (Character,  Input) 

Unstructured  entity  containing  memory  allocation  information 
on  the  DDVCT  relation.  (Character,  Input) 

Relation  containing  connectivity  data  for  the  DMVID  design  mass  matrix 
(Character,  Input) 

Relation  containing  connectivity  data  for  the  DDMVI  mass  sensitivity  ma¬ 
trix  (Character,  Input) 

Unstructured  entity  containing  the  nonlinear  mass  matrix  in  a  highly 
compressed  format  (Character,  Input) 

Unstructured  entity  containing  the  nonlinear  mass  sensitivity  matrix  in 
a  highly  compressed  format  (Character,  Input) 

Unstructured  entity  containing  the  nonlinear  design  thermal  load  parti¬ 
tions  (Character,  Input) 

Unstructured  entity  containing  the  element  nonlinear  thermal 
load  sensitivity  matrix  partitions  (Character,  Input) 

Unstructured  entity  containing  the  element  reference  temperatures  for 
nonlinearly  designed  thermal  loads,  (Character,  Input) 

Matrix  entity  containing  the  nonlinearly  designed  thermal  loads  (Charac¬ 
ter,  Output) 

Matrix  entity  containing  the  nonlinear  thermal  load  sensitivities  (Charac¬ 
ter,  Output) 

Matrix  entity  containing  the  nonlinearly  designed  gravity  loads  (Charac¬ 
ter,  Output) 
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[DDPGRV] 


Matrix  entity  containing  the  nonlinear  gravity  load  sensitivities  (Charac¬ 
ter,  Output) 


Application  Calling  Sequence: 

None 

Method: 


Design  Requirements: 

Error  Conditions: 


212 


Engineering  Application  Module:  NREDUCE 
Entry  Point:  NREDUC 


Purpose: 

Tb  reduce  the  symmetric  n-set  stiffaess,  mass  or  loads  matrix  to  the  f-set  if  there  are  single  point 
constraints  in  the  boundary  condition. 


[PN],  [PNSF{BC)],  [yS(BC)],  [KFF] ,  [KFS] / 

[PF],  [PS]  ); 

Optional  matrix  containing  the  independent  stif&iess  or  mass  matrix  to 
be  reduced  (Input) 

Optional  matrix  containing  the  apphed  loads  to  be  reduced  (Input) 

The  partitioning  vector  splitting  the  independent  degrees  of  freedom  into 
the  free  and  the  single  point  constraint  degrees  of  freedom  (Input),  where 
BC  represents  the  MAPOL  boimdary  condition  loop  index  number 

Optional  matrix  containing  the  vector  of  enforced  displacements  (Input), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number 

Optional  matrix  containing  the  reduced  form  of  KNN  (Output) 

Optional  matrix  containing  the  off-diagonal  partition  of  KFF  (Output) 

Optional  matrix  containing  the  dependent  diagonal  partition  of  KFF  (Out¬ 
put) 

Optional  matrix  containing  the  reduced  form  of  PN  (Output) 

The  load  matrix  partition  for  computation  of  spcforces  (Output) 


None 

Method: 

If  the  PN  argument  is  nonblank,  the  module  determines  the  number  of  columns  in  the  loads  matrix. 
Further,  if  the  YS  vector  is  nonblank,  it  is  expanded  to  have  the  proper  number  of  duplicate  columns. 
Having  taken  care  of  the  YS  matrix,  the  module  proceeds  to  check  if  the  KNN  argument  is  nonblank.  If 
so,  and  there  are  no  enforced  displacements,  the  KNN  matrix  is  partitioned  into  KFF  and  KFS  (if  the  KFS 
matrix  is  input).  If  there  are  enforced  displacements,  the  KSS  partition  is  also  saved  if  the  KSS  argument 
is  supplied.  The  module  then  proceeds  to  reduce  the  loads  matrix  if  the  PN  argument  is  nonblank.  If 
there  are  no  enforced  displacements,  the  matrix  is  simply  partitioned  to  PF.  When  enforced  displace¬ 
ments  are  present,  the  loads  on  the  free  degrees  of  freedom  are  computed  as: 

[PF]  =  [PF]  -  [KFS]  [YS] 

The  module  then  terminates. 


MAPOL  Calling  Sequence: 

CALL  NBKDUCE  (  [KNN], 
[KSS] , 

[KNN] 


[PN] 

[PNSF(BC)] 

[YS(BC)] 

[KFF] 

[KFS] 

[KSS] 

[PF] 

[PS] 

AppUcation  Calling  Sequence: 
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Design  Requirements: 

1.  If  there  are  nonzero  enforced  displacements,  the  stiffness  and  loads  reductions  must  be  done 
concurrently  or  the  KFS  partition  must  be  included  in  the  loads  call  as  input. 

2.  The  KFS  argument  is  always  required  when  YS  is  nonblank. 

Error  Conditions: 

None 
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Engineering  Application  Module:  OFPAEROM 
Entry  Point:  OFPARO 


Purpose: 

This  module  solves  for  the  static  aero  applied  loads  on  the  aero  boxes  and  for  the  displacements  on  the 
aero  boxes  to  satisfy  the  AIRDISP  and  tpressure  print/punch  requests.  It  loads  the  oagrdlod  and 
OAGRDDSP  relation. 


MAPOL  Calling  Sequence: 

CALL  OFPAEROM  (  NITER,  BCTD,  MINCEX,  SUB,  GSIZE,  GEOMSA,  [GTKG] ,  [GSTKG] ,  QDP, 
[AIRFRC(MINDEX)],  [DELTA { SOT) ] ,  [AICMAT{MINDEX) ] ,  [UAG(BC)], 
OAGRDLOD,  OAGRDDSP  ); 


MITER 

BCID 

MINDEX 


Design  iteration  number  (Optional,  Integer,  Input) 

User  defined  boundary  condition  identification  number  (Integer,  Input) 
Mach  number  index  associated  with  the  current  subscript  (Integer,  Input) 


SOT 


Current  Mach  number  subscript  number  (Integer,  Input) 


GSIZE 

GEOMSA 

[GTKG] 

[GSTKG] 

QDP 

[AIRFRC (MINDEX) ] 

[DELTA{SOT)] 

[AICMAT (MINDEX) ] 

[UAG(BC)] 


Number  of  g-set  DOF’s  including  any  that  may  have  been  added  by  GDR 
(Integer,  Input) 

A  relation  describing  the  aerodynamic  boxes  for  the  steady  aerodynamics 
MODEL.  The  location  of  the  box  centroid,  normsd  and  pitch  moment  axis 
are  given.  It  is  used  in  splining  the  aerodynamics  to  the  structure  and  to 
map  responses  back  to  the  aerodynamic  boxes  (Input) 

The  matrix  of  splining  coefficients  relating  the  aerodynamic  pressures  to 
forces  at  the  structural  grids  (Input) 

The  matrix  of  splining  coefficients  relating  the  structural  displacements 
to  the  streamwise  slopes  of  the  aerodynamic  boxes  (Input) 

Dynamic  pressure  associated  with  the  ciurent  subscript  (Real,  Input) 

Matrix  containing  the  aerodjmamic  forces  for  unit  configuration  parame¬ 
ters  for  the  current  Mach  number  mdex.  If  both  sjunmetric  and  antisym¬ 
metric  conditions  exist  for  the  Mach  number,  both  sets  of  configuration 
parameters  will  coexist  in  AIRFRC  (Input) 

Matrix  containing  the  set  of  configuration  parameters  representing  the 
user  input  fixed  values  and  the  trimmed  unknown  values  for  the  sot  sub¬ 
script’s  trim  cases  (Input) 

Matrix  containing  the  steady  aerodynamic  influence  coefficients  for 
either  symmetric  or  antisyunmetric  Mach  numbers  as  appropriate  for  the 
symmetry  of  the  cases  in  the  current  boundary  condition  (Input) 

Matrix  of  static  displacements  for  all  saero  subcases  in  the  current 
boundary  condition  in  the  order  the  subcases  appear  in  the  CASE  relation 
(Input),  where  BC  represents  the  MAPOL  boundary  condition  loop  index 
number 
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OAGRDLOD  A  relation  containing  the  rigid,  flexible  correction  and  flexible  forces  and 

pressures  for  each  SAERO  subcase  for  the  trimmed  configuration  parame¬ 
ters.  Outputs  are  for  the  aerodynamic  elements  whose  tpressure  out¬ 
put  was  requested  in  Solution  Control.  These  constitute  the  loads  of  the 
"trimmed”  state  of  the  configuration.  (Output) 

OAGRDDSP  A  relation  containing  the  displacements  for  each  SAERO  subcase’s  set  of 

configuration  parameters  for  the  aerodynamic  elements  whose  AIRDISP 
output  was  requested  in  Solution  Control,  These  constitute  the  trimmed 
displacements  of  the  aerodynamic  MODEL.  (Output) 

Application  Calling  Sequence: 

None 

Method: 

The  CASE  relation  is  read  to  obtain  the  list  of  all  SAERO  subcases  for  the  current  boundary  condition. 
The  AIRDISP  and  TPRESSURE  print/punch  requests  are  checked  and  the  module  terminates  if  no  output 
requests  exist. 

If  output  is  needed,  the  TRIM  relation  is  read  to  obtain  the  subscript  values  of  each  subcase.  A 
partitioning  vector  is  formed  as  the  TRIM  data  are  searched  to  extract  the  proper  columns  from  the  UAG 
matrix  for  the  subcases  associated  with  the  current  SUB  value.  Then,  for  each  subcase  to  be  processed, 
the  particular  print  and  punch  requests  are  evaluated  and,  in  the  most  general  case,  the  following  are 
computed: 

Rigid  Air  Loads: 

=  QDP* [AIRFRC] [DELTA] 

Flexible  Correction  to  the  Rigid  Air  Loads: 

=  QDP*  [  AICMAT]  [  GSTKG]  [UAG] 

Tbtal  Applied  Air  Loads: 

=  Rigid  +  Flexible 

Displacements  on  the  aero  boxes 
=  [GTKG]^[UAG] 

where  in  each  case  the  [DELTA]  and  [UAG]  matrices  are  partitioned  to  include  only  the  relevant 
subcases  for  the  current  subscript. 

Finally,  the  scratch  matrices  on  which  these  results  reside  are  read  and  output  to  the  oagrdlod  and 
OAGRDDSP  relations  for  the  loads  and  displacements,  respectively. 

Design  Requirements: 

None 

Error  Conditions: 

None 


216 


Engineering  Application  Module:  OFPALOAD 
Entry  Point:  OFPALD 


Purpose: 

Solves  for  the  static  aero  applied  loads  and  SPC  forces  to  satisfy  the  print/punch  requests.  The  resiiltant 
loads  are  written  to  the  06RIDL0D  relation. 


MAPOL  Calling  Sequence: 

CALL  OFPALOAD  (  NITER,  BCID,  MINDEX,  SUB,  GSIZE,  BGPDT(BC),  [GTKG] ,  [GSTKG] , 
QDP,  [AIRPRC (MINDEX) ] ,  [DELTA(SDB) ] ,  [AICMAT (MINDEX) ] , 
[UAG(BC)],  IMGG] ,  [AAG(BC)],  [KFS] ,  [KSS] ,  [UTU?] ,  [yS(BC)], 

[PNSF(BC)],  [PGMN(BC)],  [PFJX] ,  NGDR,  USET(BC),  OGRIDLOD  ) ; 


NITER 

BCID 

MINDEX 

SUB 


GSIZE 

BGPDT(BC) 


[GTKG] 

[GSTKG] 

QDP 

[AIRFRC (MINDEX) ] 


[DELTA(SUB)] 

[AICMAT (MINDEX) ] 

[UAG(BC)] 


Design  iteration  number  (Integer,  Input) 

User  defined  boundaiy  condition  identification  number  (Integer,  Input) 

Mach  niunber  index  for  the  current  subscript  value  (Integer,  Input) 

Subscript  number  of  SAERO  subcases  considered  in  this  cal. 

(Integer,  Input) 

Number  of  degrees  of  freedom  in  the  g-set  including  those  that  may  have 
been  added  by  GDR  (Integer,  Input) 

Relation  of  basic  grid  point  data  for  the  boimdary  condition  (including 
any  extra  points  and  GDR  scalar  points  which  may  be  added  by  the  GDR 
module)  (Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

The  matrix  of  splining  coefficients  relating  the  aerodynamic  pressures  to 
forces  at  the  structural  grids  (Input) 

The  matrix  of  splining  coefficients  relating  the  structural  displacements 
to  the  streamwise  slopes  of  the  aerodynamic  boxes  (Input) 

Dynamic  pressure  associated  with  the  current  subscript  (Real,  Input) 

Matrix  containing  the  aerodsmamic  forces  for  unit  configuration  parame¬ 
ters  for  the  current  Mach  number  index.  If  both  symmetric  and  antisym¬ 
metric  conditions  exist  for  the  Mach  number,  both  sets  of  configuration 
parameters  will  coexist  in  AIRFRC  (Input) 

Matrix  containing  the  set  of  configuration  parameters  representing  the 
user  input  fixed  values  and  the  trimmed  unknown  values  for  the  SUB  sub¬ 
script’s  trim  cases  (Input) 

Matrix  containing  the  steady  aerodynamic  influence  coefficients  for 
either  symmetric  or  antisymmetric  Mach  nvunbers  as  appropriate  for  the 
symmetry  of  the  cases  in  the  current  boundary  condition  (Input) 

Matrix  of  static  displacements  for  all  saero  subcases  in  the  current 
boundary  condition  in  the  order  the  subcases  appear  in  the  CASE  relation 
(Input),  where  BC  represents  the  MAPOL  boundary  condition  loop  index 
number 


[MGG] 


Mass  matrix  in  the  g-set  (Input) 
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[AAG(BC)] 

[KFS] 

[KSS] 
tUAF] 

[YS(BC)] 

[PNSF(BC) 

[FGMN(BC) 

[PFJK] 

NGDR 

USET(BC) 

OGRXDLOD 
Application  Calling  Sequence: 

None 

Method: 

First  the  CASE  relation  entries  for  saero  subcases  in  the  current  boundary  condition  are  read.  Then 
the  TRIM  relation  is  read  to  determine  which  subcases  are  associated  with  the  current  subscript  value. 
Then  the  output  load  and  spcf  print/punch  requests  are  examined  to  see  if  any  further  work  is  needed. 
If  no  print  or  punch  requests  are  needed  for  the  subcases  associated  with  the  suB’th  subscript,  control 
is  returned  to  the  MAPOL  sequence. 

If  SPCF  requests  exist,  the  preliminaiy  computations  are  performed  in  the  arspcf  module.  It  computes: 
[QGVl]  =  [KFS]'^{UF}  +  [KSS]{YS} 

for  all  the  appropriate  columns  of  UAF  that  are  associated  with  the  SUB'th  subscript.  The  input  YS  vector 
is  expanded  to  contain  the  correct  number  of  columns. 

Then  the  computation  of  the  apphed  loads  is  done.  First,  the  BGPDT  data  are  read  and  the  OGRIDLOD 
relation  is  opened  for  output.  Then  the  loads  for  each  subcase  in  the  subscript  is  solved  for  subject  to 
the  existence  of  a  print  request  for  that  subcase  (either  LOAD  or  SPCF).  The  following  loads  are  computed: 


Matrix  of  accelerations  for  all  SAERO  subcases  in  the  current  boundary 
condition  in  the  order  the  subcases  appear  in  the  CASE  relation  (Input), 
where  BC  represents  the  MAPOL  boundary  condition  loop  index  number 

The  off-diagonal  matrix  partition  of  the  independent  degrees  of  freedom 
that  results  from  the  SPC  partitioning  (Input) 

The  dependent  DOF  diagonal  matrix  partition  of  the  independent  de¬ 
grees  of  freedom  that  results  from  the  SPC  partitioning  (Input) 

Matrix  of  free  (f-set)  static  displacements  for  all  saero  subcases  in  the 
current  boundary  condition  in  the  order  the  subcases  appear  in  the  CASE 
relation  (Input) 

Vector  of  enforced  displacements  for  the  boundary  condition  (one  column) 
(Input) 

]  Partitioning  vector  to  divide  the  independent  DOFs  into  the  free  and  SPC 

DOFs  (Input),  where  BC  represents  the  MAPOL  boundary  condition  loop 
index  number 

]  Partitioning  vector  to  divide  the  g-set  DOFs  into  the  MPC  and  inde¬ 

pendent  DOF’s  (Input),  where  BC  represents  the  MAPOL  boundary  condi¬ 
tion  loop  index  number 

Partitioning  vector  to  divide  the  f-set  DOFs  that  may  include  GDR  gener¬ 
ated  scalar  points  into  the  original  f-set  DOF’s 

Denotes  dynamic  reduction  in  the  boimdary  condition.  (Input,  Integer) 

=s  0  No  GDR 
s=  -1  GDR  is  used 

The  Tmstructured  entity  of  DOF  masks  for  all  the  points  in  the  current 
boundary  conditions  (Input),  where  BC  represents  the  MAPOL  boundary 
condition  loop  index  number 

Relation  of  loads  on  structural  grid  points  (Output) 
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Rigid  Air  Loads  on  the  Structural  Grids 

=  QDP* [GTKG] [AIRFRC] [DELTA] 

Flexible  Correction  to  the  Rigid  Air  Loads 

=  QDP*  [GTKG]  [AIC]  [GSTKG]  [UAG] 

Total  Apphed  Load 

=  Rigid  +  Flexible 

Inertial  Load 

=  - [MGG] [AAG] 

Where  the  appropriate  inputs  are  not  available,  the  computations  are  simply  ignored  with  no  warning. 
Thus,  the  optional  calling  arguments  may  be  used  to  perform  parts  of  the  computations  without 
requiring  that  all  pieces  be  provided. 

Then,  the  output  loads  matrices  are  opened  and  the  CASE  loads  print  and  punch  requests  are  used  to 
load  the  ogridlod  relation  wilh  the  rigid,  flexible,  applied  and  inertia  loads. 

Finally,  if  any  SPCF  output  requests  exist  the  APPLIED  loads  that  were  computed  are  combined  with 
the  QGVl  terms  to  result  in  the  SPC  reaction  forces: 

[SPCF]  =  [QGVl]  -  [Applied  load] 

For  each  DOF  for  which  SPC  forces  have  been  requested. 

Design  Requirements: 

1.  SPC  force  computations  for  other  disciplines  occur  in  the  OFPSPCF  module. 

2.  Only  those  arguments  that  are  present  will  be  used.  If  data  are  missing,  the  dependent  terms  will  be 
omitted  from  the  output. 

Error  Conditions: 

None 
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Engineering  Application  Module:  OFPDISP 

Entry  Point:  OFPDSP 

Purpose: 

To  print  selected  displacements,  velocities  and/or  accelerations  from  any  analyses  in  the  current 
boimdary  condition. 

MAPOL  Calling  Sequence: 

CALL  OFFLISF  (  BCID,  NITER,  GSIZE,  BGFDT(BC),  ESIZE(BC),  FSIZE(BC), 

OGRIDDSP,  [UG(BC)],  [AG(BC)],  [UAG(BC)],  [AAG(BC)],  [BLUG] , 

[BLUE],  [UTRANG],  [UTRANE]  ,  [XJFREQG] ,  [XJFREQE] ,  LAMBDA, 
[PHIG(BC)],  [PHIBG(BC)],  LSTFLG  ) ; 


BCID 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

MITER 

Iteration  number  for  the  current  design  iteration  (Integer,  Input) 

GSIZE 

The  size  of  the  structural  set  (Integer,  Input) 

BGFDT(BC) 

Relation  of  basic  grid  point  coordinate  data  (Input),  where  BC  represents 
the  MAPOL  boundary  condition  loop  index  number 

ESIZE(BC) 

The  number  of  extra  point  degrees  of  freedom  in  the  boundary  condition 
(Integer,  Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

FSIZE(BC) 

The  size  of  the  physical  set  for  the  current  boiindary  condition. 

(Integer,  Input),  where  BC  represents  the  MAPOL  boimdary  condition 
loop  index  number 

OGRIDDSP 

Relation  for  storage  of  displacement  data  (Input) 

[UG{BC)1 

Matrix  of  global  displacements  firom  statics  analyses  (Input),  where  BC 
represents  the  MAPOL  boimdary  condition  loop  index  number 

[AG(BC)] 

Matrix  of  global  accelerations  fi-om  statics  analyses  (Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number 

[UAG(BC)] 

Matrix  of  global  displacements  from  SAERO  analyses  (Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number 

[AAG(BC)] 

Matrix  of  global  accelerations  firom  SAERO  analyses  (Input),  where  BC  rep¬ 
resents  the  MAPOL  boundary  condition  loop  index  number 

[BLUG] 

Matrix  of  global  displacements/velocities/accelerations  for  blast  re¬ 
sponse  analyses  (Input) 

[BLUE] 

Matrix  of  extra  point  displacements/velocities/  accelerations  for  BLAST  re¬ 
sponse  analyses  (Input) 

[UTRANG] 

Matrix  of  global  displacements/velocities/  accelerations  for  transient  re¬ 
sponse  analyses  (Input) 

[UTRANE] 

Matrix  of  extra  point  displacements/velocities/  accelerations  for  TRAN¬ 
SIENT  response  analyses  (Input) 

[UFREQG] 

Matrix  of  global  displacements/velocities/  accelerations  for  FREQUENCY  re¬ 
sponse  analyses  (Input) 

[TJFREQE] 

LAMBDA 

[PHIG(BC)] 

[PHIGB{BC)] 

LSTFLG 


Matrix  of  extra  point  displacements/velocities/  accelerations  for  FKE- 
QDENCY  response  analyses  (Input) 

Relational  entity  containing  the  output  from  the  real  eigenanalysis 
(Input) 

Matrix  of  global  eigenvectors  from  real  eigenanalysis  for  modes  anMyses 
(Input),  where  BC  represents  the  MAPOL  boundary  condition  loop  index 
nvunber 

Matrix  of  global  eigenvectors  for  buckling  analyses  (Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number 

Integer  flag  to  indicate  if  for  last  iteration  output  only  (Integer,  Input) 

=  1  for  last  iteration  only 
=  0  other  general  cases 


Application  Calling  Sequence: 

None 

Method: 

The  module  begins  by  reading  the  case  relation  nodal  response  quantity  print  options  for  the  cturent 
boundary  condition.  The  follovdng  print  requests  are  treated  in  the  OFPDISP  module: 

(1)  DISPLACEMENT 

(2)  VELOCITY 

(3)  ACCELERATION 

(4)  ROOTS  (for  normal  modes  analyses) 

As  the  CASE  data  are  searched,  the  fltflg  and  modflg  logicals  are  set  to  true  if  either  flutter  or 
MODES  disciplines  are  associated  with  these  print  requests.  If  no  prints  are  requested,  the  module 
terminates,  otherwise,  the  ITERLIST,  GRIDLIST,  MODELIST,  TIMELIST  and  FREQLIST  data  are 
prepared  for  easy  retrieval  in  determining  which  nodes  and  subcases  are  requested  m  each  case. 

The  BGPDT  data  are  then  read  into  open  core  and  the  number  of  extra  point  degrees  of  freedom  in  the 
current  boimdary  condition  is  determined.  Finally,  the  code  checks  to  see  if  any  flutter  displacements 
(eigenvectors)  have  been  requested  for  an  optimization  boundary  condition.  If  so,  the  request  is  exphc^y 
turned  off  since  ASTROS  does  not  compute  the  eigenvector  for  optimization  boundary  conditions.  The 
next  segment  of  code  is  set  aside  for  special  discipline  dependent  processing.  In  this  module,  the  flutter 
eigenvector  print  requires  the  transformation  of  the  modal  participation  factors  for  any  flutter  eigen¬ 
vectors  into  physical  coordinates  using  the  input  phig  matrix  and  the  flutrel  and  flutmode  entities 
that  were  created  in  the  FLUTTRAN  module.  Again,  if  no  flutter  conditions  were  found  in  the  anmysis, 
the  module  expUcitly  turns  off  the  print  request.  Otherwise,  the  physical  mode  shape  is  computed  and 
stored  in  a  pair  of  scratch  entities:  one  for  the  structural  degrees  of  freedom  and  one  for  the  extra  pomt 
degrees  of  freedom. 

The  main  loop  in  the  module  now  begins.  This  loop  is  over  all  the  disciplines  that  have  nodal  response 
quantities.  For  each  discipline,  there  is  a  loop  over  all  the  CASE  tuples  retrieved  at  the  beginning  of  the 
module.  Only  those  case  tuples  matching  the  current  discipline  are  treated  at  each  pass  of  the  outermost 
loop  The  DSPSUB  submodule  is  called  for  each  CASE  tuple  to  determine  the  number  and  identification 
numbers  for  each  subcase  for  which  output  is  desired.  A  subcase  is  considered  to  be  one  displacement/ve¬ 
locity/acceleration  vector  for  a  particular  time  step,  frequency  step,  load  condition,  etc.  Then,  dependmg 
on  the  nature  of  the  discipline,  one  of  five  print  routines  is  called  to  read  into  memory  the  proper  nodal 
vector  and  print  the  terms  to  the  user  output  file.  Once  all  the  subcases  for  the  current  CASE  tuple  have 
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been  processed,  the  CASE  tuple  loop  continues  for  the  current  discipline.  When  all  disciplines  or  all  CASE 
tuples  have  been  processed,  the  module  terminates. 

Design  Requirements: 

1.  The  OFPDISP  module  is  designed  to  be  called  at  the  conclusion  of  the  boimdary  condition  loop  when 
all  the  physical  nodal  response  quantities  have  been  computed  for  all  the  analyzed  disciplines. 

Error  Conditions: 

None 
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Engineering  Application  Module:  OFPDLOAD 

Entry  Point:  OFPDLD 


Purpose: 

Processes  the  solution  control  load  output  requests  for  the  current  boundary  condition  for  dynamic  loads 
(transient,  frequency  and  gust)  and  stores  the  loads  on  the  physical  degrees  of  freedom  to  the  OGRIDLOD 
relation  for  those  subcases  and  grids  selected  in  solution  control. 


MAPOL  Calling  Sequence: 

CALL  OFPDLOAD  (  NITER,  BCID,  BGPDT(BC)/  PSIZE(BC),  ESIZE(BC),  [FHIG(BC)], 
[PTGLOAD],  [PTHLOAD],  [PFGLOAD] ,  [PFHLOAD] ,  OGRIDLOD  ); 


NITER 


Current  design  iteration  number  (Integer,  Input) 


BCID 


User  defined  boundary  condition  identification  number  (Integer,  Input) 


BGPDT(BC) 

PSIZE(BC) 

ESIZE(BC) 

[PHIG(BC)] 

[PTGLOAD] 

[PTHLOAD] 

[PFGLOAD] 

[PFHLOAD] 

OGRIDLOD 


Relation  of  basic  grid  point  data  for  the  boundary  condition  (including 
any  eirtra  points  and  gdr  scalar  points  which  may  be  added  by  the  GDR 
module)  (Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

The  size  of  the  physical  set  for  the  current  boundary  condition 
(Integer,  Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

Number  of  extra  point  DOFs  defined  for  the  boundary  condition 
(Integer,  Output),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

Matrix  of  normal  mode  eigenvectors  in  the  structural  g-set  (Input),  where 
BC  represents  the  MAPOL  boundary  condition  loop  index  number 

Matrix  of  g-set  appUed  dynamic  loads  for  the  direct  transient  analyses  in 
the  current  boundary  condition  (Input) 

Matrix  of  h-set  applied  dynamic  loads  for  the  modal  transient  GUST  analy¬ 
ses  in  the  cmrent  boundary  condition  (Input) 

Matrix  of  g-set  applied  dynamic  loads  for  the  direct  frequency  analyses  in 
the  current  boimdary  condition  (Input) 

Matrix  of  h-set  applied  dynamic  loads  for  the  modal  frequency  analyses 
with  GUST  in  the  current  boundary  condition  (Input) 

Relation  of  applied  loads  on  structural  grid  points  (Output) 


Application  Calling  Sequence: 

None 

Method: 

The  CASE  relation  is  read  for  aU  transient  and  frequency  response  analysis  and  the  LOADPRNT  print 
and  punch  requests  for  loads  are  exzunined.  If  any  requests  exist,  processing  continues  by  opening  the 
BGPDT  and  reading  the  intemal/extemal  point  identifications  to  allow  storing  the  matrix  data  or  the 
OGRIDLOD  relation  labelled  with  the  external  ids. 
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If  any  GUST  loads  are  requested,  the  modal  dynamic  loads  are  transformed  to  the  physical  degrees  of 
freedom  as: 

[PGUSTT]  =  [PHIG]  [PTHLOAD]  for  transient  gust 
[PGUSTF]  =  [PHIG]  [PPHLOAB]  for  harmonic  gust 

To  perform  these  operations,  the  normal  modes  must  be  expanded  to  include  extra  points  for  the  single 
subcase  of  transient  and  or  frequency  that  is  allowed.  Then  the  multiphcations  are  performed. 

Finally,  once  all  the  direct  matrices  are  available,  the  CASE  control  print  requests  are  processed,  the 
corresponding  columns  are  identified  by  interpreting  the  time  or  FREQ  options  and  the  gridlist  data 
are  read  to  determine  which  points  are  chosen.  The  terms  are  then  written  to  the  OGRIDLOD  relation 
as  APPLIED  loads. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  OFPEDR 

Entry  Point:  OFPEDR 

Purpose: 

lb  print  selected  element  stress,  strain,  force  and/or  strain  energies  from  any  analyses  in  the  current 
boundary  condition. 

MAPOL  Calling  Sequence: 

("aT.T.  OFPEDR  {  BCID,  HSIZE(BC),  NITER,  LSTFLG  ); 


BCID 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

HSIZ£(BC) 

Number  of  modal  dynamic  degrees  of  freedom  in  the  current  bounda^ 
condition  (Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

NITER 

Iteration  number  for  the  current  design  iteration  (Integer,  Input) 

LSTFLG 

Integer  flag  to  indicate  if  for  last  iteration  output  only  (Integer,  Input) 

=  1  for  last  iteration  only 
=  0  other  general  cases 

Application  Calling  Sequence: 

None 

Method: 

The  module  begins  by  reading  the  CASE  relation  element  response  quantity  print  options  for  the  current 
boundary  condition.  The  following  print  requests  are  treated  in  the  OFPEDR  module: 

(1)  STRESS 

(2)  STRAIN 

(3)  FORCE 

(4)  ENERGY 

If  no  prints  are  requested,  the  module  terminates,  otherwise,  the  iterlist,  elemlist,  modelist, 
TIMELIST  and  FREQLIST  data  are  prepared  for  easy  retrieval  in  determining  which  elements  and 
subcases  are  requested  in  each  case.  The  main  loop  in  the  module  now  begins.  This  loop  is  over  all  the 
disciplines  that  have  element  response  quantities. 

For  each  discipline,  there  is  a  loop  over  all  the  case  tuples  retrieved  at  the  beginning  of  the  module. 
Only  those  CASE  tuples  matching  the  current  discipline  are  treated  at  each  pass  of  the  outermost  loop. 
The  OFPSUB  submodule  is  called  for  each  CASE  tuple  to  determine  the  number  and  identification 
numbers  for  each  subcase  for  which  output  is  desired.  A  subcase  is  considered  to  be  one  displacement 
vector  for  a  particular  time  step,  frequency  step,  load  condition,  etc.  For  each  subcase,  the  set  of  element 
response  print  utihties  (one  for  each  element  type)  are  called  for  each  of  the  four  quantities  that  can  be 
printed.  If  the  strain  energy  is  requested,  the  ofpese  submodule  is  called  to  compute  the  total  str^ 
energy  for  the  current  displacement  field  as  a  preface  operation  prior  to  the  element  dependent  print 
routines.  Once  aU  the  quantities  for  aU  the  subcases  for  the  current  CASE  tuple  have  been  processed, 
the  CASE  tuple  loop  continues  for  the  current  discipline.  When  all  disciplmes  or  all  CASE  tuples  have 
been  processed,  the  module  terminates. 

Design  Requirements: 
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1.  The  OFPEDR  modiile  is  designed  to  be  called  at  the  conclusion  of  the  boundary  condition  loop  when 
all  the  physical  nodal  response  quantities  have  been  computed  for  all  the  analyzed  disciplines. 

2.  The  EDR  module  must  have  been  called  to  store  the  computed  element  response  quantities  onto  the 
EOxxxx  entities  which  are  read  by  the  ofpedr  module. 

Error  Conditions: 

None 
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Engineering  Application  Module:  OFPGRAD 
Entry  Point:  OFPGRA. 

Purpose: 

Stores  the  data  necessary  to  satisfy  the  solution  control  print  and  punch  requests  ogradient  and 
CGRADIENT  (objective  function  gradient  and  constraint  gradient,  respectively). 

MAPOL  Calling  Sequence: 

CALL  OFPGRAD  (  NITER,  [AMAT] ,  GLBDES,  CONST,  CONSTORD,  GRADIENT 


NITER 

Design  iteration  number  (Integer,  Input) 

[AMAT] 

The  matrix  of  constraint  gradients  for  active  constraints  in  the  current  de¬ 
sign  iteration  (Input) 

GLBDES 

The  relation  of  global  design  variable  values  and  objective  function  sensi¬ 
tivities  for  all  design  iterations  that  have  been  analyzed.  (Input) 

CONST 

The  relation  of  applied  design  constraints  for  all  design  iterations  (Input) 

CONSTORD 

The  relation  of  reordered  design  constraints  for  the  current  design  itera¬ 
tion  (Input) 

GRADIENT 

The  relation  of  output  constraint  gradients  for  the  requested  constraints 
and  design  variables  that  satisfy  the  Solution  Control  CGRADIENT  and 
OGRADIENT  output  requests  (Output) 

Application  Calling  Sequence: 

None 

Method: 

The  OPTIMIZE  relation  is  read  to  determine  if  any  OGRADIENT  or  CGRADIENT  print  or  punch  requests 
exist.  If  they  do,  processing  continues  by  determining  if  this  iteration  is  in  the  set  of  iterations  selected. 
If  it  is,  the  the  AMAT  matrix  is  opened  and  read  into  memory  as  are  the  glbdes  entries  for  the  current 
iteration.  The  CONST  relation  is  read  into  memory  and  reordered  to  match  the  AMAT  matrix.  Then  the 
GRADIENT  entity  is  loaded  with  the  objective  or  constraint  gradient  terms  for  the  requested  constraints 
and  global  design  variables. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  offload 
Entry  Point:  OPPLOD 


Purpose: 

lb  print  selected  applied  external  loads  from  any  analyses  in  the  current  boundary  condition. 
MAPOL  Calling  Sequence: 

CALL  OFFLOAD  {  BCID,  NITER,  GSIZE,  BGPDT(BC),  PSIZE(BC),  [PG]  , 

TRMTYP,  QDP,  [GTKG] ,  [AIRFRC (MINDEX) ] ,  [DELTA]  ); 


BCID 

User  defined  botindaiy  condition  identification  number  (Integer,  Input) 

NITER 

Iteration  nmnber  for  the  current  design  iteration  (Integer,  Input) 

GSIZE 

The  size  of  the  structural  set  (Integer,  Input) 

BGPDT (BC) 

Relation  of  basic  grid  point  coordinate  data  (Input),  where  BC  represents 
the  MAPOL  boundary  condition  loop  index  number 

PSIZE(BC) 

The  size  of  the  physical  set  for  the  ciorrent  boundary  condition. 

(Integer,  Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

[PG] 

Matrix  of  applied  loads  for  STATICS  analyses  in  the  current  boundary 
condition  (Input) 

TRMTYP 

The  trim  t3^e  for  the  steady  aeroelastic  analyses  =  0  zero  degree  of  free¬ 
dom  trim  =  1  lift  only  trim  =  2  lift/pitching  moment  trim  (Integer,  Input) 

QDP 

Dynamic  pressure  for  the  saero  analyses  in  the  current  boundary  condi¬ 
tion  (Real,  Input) 

[GTKG] 

Matrix  containing  the  steady  aerodynamic  spline  in  the  structural  set 
(Input) 

[AIRFRC (MINDEX) ] 

Matrix  containing  the  aerodynamic  forces  for  unit  configuration  parame¬ 
ters  for  the  current  Mach  number  and  S5nfnmetry  (Input) 

[DELTA] 

Matrix  containing  the  configuration  parameter  values  resulting  from  the 
current  trim  condition  (Input) 

Application  Calling  Sequence: 

None 

Method: 

The  module  begins  by  reading  the  case  relation  applied  load  print  options  for  the  current  boundary 
condition.  The  LOAD  print  requests  are  treated  in  the  offload  module  for  all  ASTROS  disciplines.  As 
the  CASE  data  are  searched,  the  aroflg  logical  is  set  to  true  if  any  saero  cases  with  a  trmtyp  greater 
than  zero  are  foimd.  If  no  prints  are  requested,  the  module  terminates,  otherwise,  the  GRIDLIST, 
MODELIST,  TIMELIST  and  FREQLIST  data  are  prepared  for  easy  retrieval  in  determining  which  nodes 
and  subcases  are  requested  in  each  case.  The  bgpdt  data  are  then  read  into  open  core  and  the  number 
of  extra  point  degrees  of  freedom  in  the  current  boundary  condition  is  determined.  The  next  segment  of 
code  is  set  aside  for  special  discipline  dependent  processing.  In  this  module,  the  steady  air  loads 
associated  with  TRIM  analyses  must  be  computed  from  the  AIRFRC  matrix  of  loads  due  to  "imit" 
configuration  parameters  and  the  DELTA  matrix  of  trimmed  configuration  parameters.  The  result  must 
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then  be  splined  to  the  structural  degrees  of  freedom  using  the  GTKG  spline  transformation  matrix,  ^e 
structural  applied  loads  are  stored  in  a  scratch  entity  for  use  in  the  subsequent  print  processuig.  "Hie 
main  loop  in  the  module  now  begins.  This  loop  is  over  all  the  disciplines  that  have  apphed  loads^For 
each  discipline,  there  is  a  loop  over  all  the  case  tuples  retrieved  at  the  beginning  of  the  module,  (^y 
those  CASE  tuples  matching  the  current  discipline  are  treated  at  each  pass  of  the  outermost  loop.^e 
LODSUB  submodule  is  called  for  each  CASE  tuple  to  determine  the  number  and  identification  numbers 
for  each  subcase  for  which  output  is  desired.  Asubcase  is  considered  to  be  one  load  vector  for  a  particular 
time  step,  frequency  step,  load  condition,  etc.  Then,  depending  on  the  nature  of  the  disciplme  one  ot 
two  print  routines  is  called  to  read  into  memory  the  proper  vector  and  to  prmt  the  terms  to  the  user 
output  ffle.  Once  all  the  subcases  for  the  current  CASE  tuple  have  been  processed,  the  CASE  tuple  loop 
continues  for  the  current  discipline.  When  all  disciplines  or  all  CASE  tuples  have  been  processed,  the 
module  terminates. 

Design  Requirements: 

1.  The  OFPLOAD  module  is  designed  to  be  called  at  the  conclusion  of  the  boxmdary  condition  loop. 

Error  Conditions: 

None 
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Engineering  Application  Module :  OFPMROOT 


Entry  Point:  OFPMRT 
PiUT)Ose: 

Processes  the  solution  control  normal  modes  root  output  requests. 
MAPOL  Calling  Sequence: 

CALL  OFPMROOT  (  NITER,  BCID,  LAMBDA,  LASTFLAG  )  ; 


NITER 

BCID 

LAMBDA 

LASTFLAG 


Current  design  iteration  number.  (Integer,  Input) 

User  defined  boxmdary  condition  identification  number  (Integer,  Input) 

The  relation  of  normal  modes  eigenvalues  for  all  boundary  conditions  and 
design  iterations  (Input) 

An  optional  argument  which,  if  nonzero,  implies  that  the  call  is  being 
made  only  to  satisfy  ITER=LAST  print  or  punch  requests  (Integer,  Input) 


Application  Calling  Sequence: 
None 


Method: 

The  CASE  relation  is  read  to  obtain  the  print/punch  requests  for  ROOTS.  If  any  requests  exist,  they  are 
processed.  If  the  IASTFIAG  is  nonzero,  only  those  requests  in  which  the  ITER=IiAST  flag  is  set  in  the 
ROOTPRNT  CASE  relation  attribute  are  considered. 

For  the  modes  selected  by  the  modelist,  the  OEIGS  and  IiAMBDA  entities  are  read  and  the  eigenvalue 
extraction  summary  table  and  the  extracted  eigenvalues  are  printed  to  the  output  file.  Punch  requests 
are  ignored  since  the  data  are  stored  already  on  the  lambda  relation. 

Design  Requirements: 

None 


Error  Conditions: 
None 
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Engineering  Application  Module:  OFPSPCF 
Entry  Point:  OFPSPF 


Piirpose: 

Recovers  single-point  forces  of  constraint  and  loads  the  results  to  the  OGRIDLOD  relation 
MAPOL  Calling  Sequence: 

CALL  OFPSPCF  (  NITER,  BCID,  BC,  DISC,  CMPLX,  GSIZE,  ESIZE(BC),  NGDR,  [KFS] , 
[KSS],  [UF],  [YS(BC)],  [PS],  [PNSF(BC)],  [PGMN(BC)  ]  ,  [PFCIK] , 

[PHIG(BC)],  [PGLOAD],  [PHLOAD] ,  BGPDT(BC),  OGRIDLOD  ); 


NITER 

BCID 

BC 

DISC 


CMPLX 

GSIZE 

ESIZE(BC) 

NGDR 

[KFS] 

[KSS] 

[DF] 

[YS(BC)] 

[PS] 

[PNSF(BC)] 


Current  design  iteration  number  (Optional,  Integer,  Input) 

User  defined  boimdary  condition  identification  number  (Integer,  Input) 

The  MAPOL  boundary  condition  loop  index  number  (Integer,  Input) 

Integer  key  indicating  the  discipline  whose  SPC  forces  are  to  be  recovered. 

=1  for  statics 

=2  for  modes 

=4  for  flutter 

=5  for  transient  analysis 

=6  for  frequency  analysis 

=8  for  nuclear  blast 

Note  that  static  aeroelasticity  (disc=3)  is  supported  in  the  ofpaload 
module.  (Integer,  Input) 

Integer  flag  indicating  whether  the  discipline’s  displacement  field  is  real 
(=1)  or  complex  (=2)  (Integer,  Input) 

Number  of  degrees  of  freedom  in  the  g-set  including  those  that  may  have 
been  added  by  GDR  (Integer,  Input) 

Number  of  extra  point  DOFs  defined  for  the  botmdaiy  condition  (Integer, 
Output) 

Denotes  dynamic  reduction  in  the  boundary  condition.  (Input,  Integer) 

=  0  No  GDR 
=  -1  GDR  is  used 

The  off-diagonal  matrix  partition  of  the  independent  degrees  of  freedom 
that  results  firom  the  SPC  partitioning  (Input) 

The  dependent  DOF  diagonal  matrix  partition  of  the  independent  de¬ 
grees  of  freedom  that  results  from  the  SPC  partitioning  (Input) 

Matrix  of  free  (f-set)  static  displacements  for  all  the  DISC  subcases  in  the 
current  boundary  condition  in  the  order  the  subcases  appear  in  the  CASE 
relation  (Input) 

Vector  of  enforced  displacements  for  the  boundary  condition  (one  column) 
(Optional,  Input) 

Matrix  of  static  loads  applied  to  the  SPC  DOF’s  (Partition  of  the  free  DOF 
loads  matrix)  (Optional,  Input) 

Partitioning  vector  to  divide  the  independent  DOFs  into  the  free  and  SPC 
DOFs  (Input) 
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[P6MN(BC)] 

Partitioning  vector  to  divide  the  g-set  DOFs  into  the  mpc  and  inde¬ 
pendent  DOFs  (Input) 

[PFJK] 

Partitioning  vector  to  divide  the  f-set  DOFs  that  may  include  GDR  gener¬ 
ated  scalar  points  into  the  original  f-set  DOF’s  (Optional,  but  required  if 
NGDR  <>0;  Input) 

[PHI6(BC)] 

Matrix  of  normal  mode  eigenvectors  in  the  structural  g-set 
(Optional,  Input) 

[PGLOAB] 

Matrix  of  g-set  applied  dynamic  loads  for  the  direct  transient  or  fre¬ 
quency  analyses  (as  appropriate  for  disc)  in  the  current  boundary  condi¬ 
tion  (Optional,  Input) 

[PHLOAB] 

Matrix  of  h-set  applied  dynamic  loads  for  the  modal  transient  or  fre¬ 
quency  GUST  analyses  (as  appropriate  for  Disc)  in  the  current  boundary 
condition  (Optional,  Input) 

BGPDT (BC) 

Relation  of  basic  grid  point  data  for  the  boimdary  condition  (including 
any  extra  points  and  GDR  scalar  points  which  may  be  added  by  the  GDR 
module)  (Input),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

OGRIDLOD 

Relation  of  loads  on  structiu-al  grid  points  (Output) 

Application  Calling  Sequence: 

None 

Method: 

This  modxile  computes  the  SPC  reaction  forces  for  all  disciplines  in  ASTROS  except  SAERO  and  NPSAERO. 
NPSAERO  has  no  structural  loads  and  the  SAERO  SPC  forces  are  computed  in  the  OFPALOAD  module 
where  the  applied  loads  (an  input  to  the  SPC  computations)  are  computed. 

First  the  CASE  relation  is  read  for  all  entries  with  a  DISFLAG  of  DISC  for  the  ciurent  boxmdary  condition. 
Then  the  SPCF  print  requests  are  examined  to  determine  if  any  output  is  needed  for  this  discipline, 
design  iteration,  etc.  If  not,  the  module  terminates  otherwise  computations  continue  with  the  creation 
of  scratch  entities  to  hold  the  constituent  parts  of  the  SPC  calculations.  The  bgpdt  data  are  read  into 
memory  and  the  OGRIDLOD  relation  is  opened  m  preparation  for  output. 

The  existence  of  enforced  displacements,  YS  and  loads  on  the  SPC  dofs,  PS  is  checked  and  logical  flags 
are  set  for  downstream  computations.  If  GDR  was  used  (as  indicated  by  N6DR  <>0),  the  PFJK  partition 
matrix  is  used  to  extract  the  original  f-set  DOF  from  UF  from  the  input  set  which  includes  GDR  scalar 
points. 

Then  some  discipline  dependent  processing  takes  place.  If  DISC  =  4  (flutter),  the  FLMODE  hidden 
entity  is  read  and  the  flutter  eigenvectors  (if  any)  are  read,  stripped  of  the  extra  point  degrees  of  freedom 
and  reduced  to  the  f-set.  Transient  and  frequency  disciplines  require  special  processing  because  of  the 
nature  of  the  displacement  matrices  (containing  velocities  and  accelerations).  This  processing  is  done 
in  DYSPCF  and  results  in  a  g-set  sized  matrix  of  the  loads  apphed  to  the  SPC  DOFs  for  each  time  or 
frequency  step.  GUST  loads  are  treated  here  to  recover  the  direct  apphed  loads  from  the  PHLOAD  input. 
Extra  points  are  partitioned  out  of  these  loads  matrices  if  needed. 

Then  the  actual  recovery  process  begins.  First  the  QSV  matrix  of  SPC  forces  are  computed  from  the 
appropriate  constituent  terms 

[QSV]  =  [KFS]'^{UF}  +  [KSS]{YS}  -  {PS} 


where  YS  has  been  expanded  to  have  the  appropriate  number  of  columns  and  the  proper  terms  are 
ignored  if  YS  or  PS  is  blank  or  empty. 

Then  the  QSV  matrix  is  expanded  to  the  g-set,  the  nonzero  terms  are  read  and  compared  to  the  output 
requests  and  the  appropriate  terms  are  loaded  to  the  ogridlod  relation.  For  the  dynamic  response 
disciplines,  the  applied  loads  PS  are  extracted  from  the  g-set  output  of  the  dyspcp  submodule  and  the 
reaction  forces  are  adjusted  accordingly. 

Design  Requirements: 

1.  SAERO  single  point  constraint  reactions  are  computed  in  the  OFPALOAD  module  where  the  applied 
loads  are  computed. 

Error  Conditions: 

None 
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Engineering  Application  Module:  pbkleval 
Entry  Point:  BKLEVA 


Purpose: 

Evaluates  the  current  values  of  the  panel  buckling  constraints. 

MAPOL  Calling  Sequence: 

CALL  PBKLEVAL  {  BCID,  NITER,  NDV,  GLBDES,  LOCLVAR,  [PTRANS] ,  CONST, 
PDLIST,  OPNLBUCK  ); 


BCID 

NITER 

NDV 

GLBDES 

LOCLVAR 

[PTRANS] 

CONST 

PDLIST 


OPNLBUCK 

Application  Calling  Sequence: 
None 


User  defined  boundary  condition  identification  number  (Integer,  Input) 

Design  iteration  number  (Integer, Input) 

Number  of  design  variables  (Integer,Input) 

Relation  of  global  design  variables  (Character,Input) 

Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Character,Input) 

The  design  variable  linking  matrix  (Character,Input) 

Relation  of  constraint  values  (Character,Output) 

Relation  containing  panel  buckling  constraint  sensitivity  informa- 
tion.(Character,Output) 

Relation  containing  panel  buckling  constraint  output  (Character, Output) 


Method: 

This  module  first  checks  if  any  DCONBK  bulk  data  entries  referenced  by  any  STATICS  and/or  SAERO 
disciplines  at  the  current  boundary  condition  to  determine  if  there  are  any  panel  buckling  constraints 
apphed.  If  any  are  foimd,  the  QUAI)4  and/or  TRIA3  element  data  are  obtained  from  relation  QUAD4EST 
and/or  TRI A3EST;  the  element  force  data  are  obtained  firom  relation  EOQD4  and/or  EOTR3 ;  and  the  panel 
buckling  constraint  values  are  evaluated  and  stored  into  relation  CONST.  The  constraint  sensitivity  data 
are  also  prepared  in  this  module. 

Design  Requirements: 

Because  this  module  requires  the  element  output  relation  fi-om  module  EDR,  it  should  only  be  called 
after  that  module. 

Error  Conditions: 

The  element  has  no  force  data  for  buckling  constraint  evaluation  is  flagged. 
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Engineering  Application  Module:  PBKLSENS 

Entry  Point:  BKSENS 

Purpose: 

Evaluates  the  panel  buckling  constraint  sensitivity. 


MAPOL  Calling  Sequence: 

CALL  PBKLSENS  (  BCID, 

,  NITER,  NDV,  GLBDES,  LOCLVAR,  [PTRANS] ,  PDLIST,  [AMAT]  ) 

BCID 

User  defined  boimdary  condition  identification  number  (Integer,  Input) 

NITER 

Design  iteration  mnnber  (Integer,Input) 

NDV 

Number  of  design  variables  (Integer,Input) 

GLBDES 

Relation  of  global  design  variables  (Character,Input) 

LOCLVAR 

Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Character,Input) 

[PTRANS] 

The  design  variable  linking  matrix  (Character,Input) 

PDLIST 

Relation  containing  panel  buckling  constraint  sensitivity  information 
(Character,Input) 

[AMAT] 

Matrix  containing  the  sensitivity  of  the  constraints  to  changes  in  the  de¬ 
sign  variable  (Character, Output) 

Application  Calling  Sequence: 

None 

Method: 

This  module  first  check  if  any  active  panel  buckling  constraints  for  the  cmrent  bormdary  condition  and 
obtained  the  prepared  constraint  sensitivity  data  fi'om  relations  PDLIST  and  CONST.  Then  the  local 
design  variable  data  is  obtained  from  relation  loclvar.  For  each  active  panel  buckling  constraint,  the 
sensitivity  to  the  design  variables  is  computed  and  stored  into  matrix  [AMAT] . 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  PFBULK 
Entry  Point:  PFBULK 


Purpose: 

To  perform  a  number  of  preface  operations  to  form  additional  collections  of  data  and  to  make  error  checks 
not  done  in  IFP  to  identify  input  errors  before  costly  analyses  are  performed. 


MAPOL  Calling  Sequence: 

CALL  PFBXJLK  (  GSIZEB, 

,  EOSUEERY,  EODISC,  GPFELEM  ); 

GSIZEB 

Length  of  the  g-set  vectors  (Integer,  Input) 

EOSUMMRY 

Relational  entity  containing  the  summary  of  entities  for  which  element 
response  quantities  are  desired  (Output) 

EODISC 

Unstructured  entity  referred  to  by  an  attribute  of  EOSUMMRY  containing 
the  set  of  disciplines  and  subcases  for  the  element  response  quantities 

GPFELEM 

Relational  entity  containing  the  set  of  elements  connected  to  grid  points 
for  which  grid  point  forces  are  desired  (Output) 

Application  Calling  Sequence: 
None 


Method: 

This  module  first  computes  the  coordinate  functions  and  centroid  functions  which  are  required  by  any 
user  function  constraints.  Those  response  values  are  stored  into  relational  entities  to  be  used  by  the 
function  evaluation  utilities.  Then  the  module  performs  tests  on  selected  bulk  data  entities  to  see  if  they 
contain  data.  If  they  do,  the  indicated  subroutine  is  called  to  generate  further  data  and  perform  error 
checks: 


BULK  DATA 

SUBROUTINE 

GENERATED  ENTITY 

TEMP,  TEMPD 

PRETMP 

GRIDTEMP 

FREQ,  FREQl,  FREQ2 

PREFRQ 

FREQL 

TSTEP 

PRETST 

OTL 

The  module  also  checks  that  constraint  requests  specified  in  the  flutter  solution  control  command 
have  corresponding  dconflt  bulk  data  entries. 

As  a  final  step,  the  PFBULK  module  performs  the  preliminary  processing  of  solution  control  print 
requests  that  depend  on  elements.  These  include  all  the  element  response  quantities  (i.e.,  stress  or 
strain)  and  the  grid  point  force  balance.  The  first  stage  is  performed  in  the  PREGPF  submodule  which 
builds  the  GPFELEM  relation  from  the  element  connectivity  data  and  the  sets  of  nodes  for  which  a  force 
balance  in  requested.  Then  the  peeedr  submodule  is  called  to  build  the  eosummry  and  EODISC  entities 
which  list  those  elements  for  which  element  data  recovery  should  be  performed  in  the  EDR  module.  These 
entities  are  also  used  in  OFPEDR  to  direct  the  printing  of  the  computed  quantities. 
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Design  Requirements: 

1.  This  is  a  preface  module  that  called  after  EMG  and  makest 
Error  Conditions: 

None 
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Engineering  Application  Module:  QHHL6EN 
Entry  Point:  QHH6EN 


Purpose: 

lb  compute  the  discipline  dependent  unsteady  aerodynamic  matrices  for  gust  analyses  in  the  modal 
dynamic  degrees  of  freedom. 

MAPOL  Calling  Sequence: 

CALL  QHHLGEN  (  BCID,  ESIZE(BC),  [QKKL] ,  [QKJL] ,  [UGTKA] ,  [PHIA] ,  [PHIKH] , 
[QHHL],  [QHJL]  ); 

BCID  User  defined  boimdary  condition  identification  number  (Integer,  Input) 

ESIZE  (BC)  The  number  of  extra  point  degrees  of  freedom  in  the  boundary  condition 

(Integer,  Input),  where  BC  represents  the  MAPOL  boimdary  condition 
loop  index  number 

Matrix  list  containing  the  matrix  product  (Output): 

[SKJ]  [AJJT]"’^(  [DlJKl  +  ik[D2JK]) 
used  for  flutter  and  gust  analyses  (Input) 

Matrix  hst  containing  the  matrix  product: 

ISKJ]  [AJJT]“® 
used  for  gust  analyses  (Input) 

Matrix  containing  the  unsteady  aerodynamic  spline  in  the  analysis  set 
(Input) 

Matrix  containing  the  real  eigenvectors  in  the  analysis  set  (Input) 

Matrix  containing  the  matrix  product  (Output): 

[UGTKA]  [PHIA] 

with  the  analysis  set  expanded  to  include  extra  points  (Output) 

The  modal  unsteady  aerodynamic  influence  coefficients  for  gust  (Output): 

[PHIKH] ’^[QKK]  [PHIKH] 

The  modal  unsteady  aerod3mamic  influence  coefficients  for  gust  (Output): 

[  PHIKH] ’‘[QKJ] 

Application  Calling  Sequence: 

None 

Method: 

The  QHLLGEN  module  begins  by  retrieving  all  the  CASE  tuples  for  the  current  boundary  condition.  The 
number  of  gust  options  on  transient  or  frequency  response  disciplines  are  coxmted  to  determine  what 
actions  are  required  by  the  module.  If  gust  conditions  do  not  exist,  control  returns  to  the  executive.  If 
QZHH  and  QJH  are  required,  the  module  continues  by  reading  the  BGPDT  data  to  determine  the  size  of 
the  direct  dynamic  degrees  of  freedom  including  extra  points.  If  extra  points  exist,  the  normal  modes 
and  the  unsteady  spline  matrix  (input  in  the  analysis  set)  are  expanded  to  include  the  extra  point  degrees 


[QKKL] 

[QKJL] 

[UGTKA] 

[PHIA] 

[PHIKH] 

[QHHL] 

[QHJL] 
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of  freedom.  The  module  then  computes  the  phikh  matrix  of  structural  mode  shapes  splined  to  the 
aerodynamic  degrees  of  freedom,  qhllgen  then  calls  the  prunmk  utility  to  prepare  the  unmk  data  for 
the  discipline  dependent  tmsteady  aerodynamic  matrices.  The  total  number  of  m-k/symmetry  sets 
associated  with  the  QKK  matrix  are  computed  and  the  requisite  memory  for  the  subsequent  computations 
is  obtained.  The  module  then  proceeds  with  the  premultiplication  of  the  QKK  matrix  list  by  the  PHIKH 
matrix: 


[QHKL]  =  [PHIKH] [QKKL] 

The  QHLL  output  matrix  is  then  flushed  and  computed  using  one  of  two  paths.  If  there  is  only  one 
m-k/symmetry  set  (which  is  very  rare),  the  QHLL  matrix  may  be  formed  by  a  post-multiplication  of  QHIX 
in  one  step.  If  more  than  one  matrix  is  in  the  QHKL  matrix  list,  however,  the  module  extracts  each  matrix 
individually  using  the  exqkk  utility  and  performs  the  multiplication: 

[QZHH]  =  [QHK] [PHIKH] 

and  appends  the  resultant  matrix  onto  QHLL. 

The  matrix  QHJL  is  also  output.  Since  this  matrix  only  requires  a  premultiplication  of  the  input  QKJL 
matrix  list  by  PHIKH,  it  is  performed  in  one  step  and  the  module  terminates. 

Design  Requirements: 

1.  The  UNSTE2VDY  module  must  have  been  executed  to  generate  the  aerodynamic  matrices  and  generate 
the  UNMK  entity. 

Error  Conditions: 
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Engineering  Application  Module:  RBCHECK 

Entry  Point:  RDGCHK 

Purpose: 

lb  compute  the  rigid  body  strain  energies  associated  with  displacements  of  each  support  degree  of 
freedom. 

MAPOL  Calling  Sequence: 

CALL  KBCHECK  (  BCID, 

BCID 
USET(BC) 

B6PDT(BC) 

[D(BC)] 

[KLL] 

[KRR] 

[KLR] 

Application  Calling  Sequence: 

None 
Method: 

The  RBCHECK  module  begins  by  checking  if  the  USET  entity  contains  any  support  (r-set)  degrees  of 
freedom.  If  not,  the  module  returns.  The  module  continues  by  reading  the  bgpdt  into  memory  and  then 
computing  the  strain  energy  eissociated  with  the  rigid  body  displacements: 

[X]  =  [KLR]^  [D]  +  [KRR] 


USET(BC),  BGPDT (BC),  [D{BC)],  [KLL],  [KRR],  [KLR]  ) ; 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

The  \mstructured  entity  defining  structural  sets  (Input),  where  BC  repre¬ 
sents  the  MAPOL  boundary  condition  loop  index  number 

Relation  containing  basic  grid  point  coordinate  data  (Input),  where  BC 
represents  the  MAPOL  boundary  condition  loop  index  number 

Rigid  body  transformation  matrix  (Input),  where  BC  represents  the 
MAPOL  boundary  condition  loop  index  number 

The  stifl&iess  matrix  in  the  1-set  degrees  of  fireedom  (Input) 

The  stiffiiess  matrix  in  the  r-set  degrees  of  freedom  (Input) 

The  off-diagonal  1-r  partition  of  the  a-set  stiffiiess  matrix  (Input) 


The  X  and  KRR  matrices  are  then  read  into  memory  and  two  normalization  measures  are  computed.  The 
first  is  the  overall  norm  of  each  matrix: 

nr  nr 

Xnorm  —  ^  1  Xij  | 

i=l  j=l 

TIT  nr 

KRRnorm  =  ^  ^  I  KRRy  | 

1=1  J=1 

_  Xnorm 
ematrix  --  KRRnorm 

The  second  is  the  norm  of  each  of  the  nr  columns: 
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nr 

Xjnorm  =  X  1  I 
i=l 

nr 

T^jnorm  =  X  I  ' 

1=1 

^  _  norm 

^col  "  KRR^ 

norm 

These  error  ratios  and  norms  are  then  printed  out  along  with  the  associated  diagonal  of  x  (the  strain 
energy)  for  each  support  degree  of  freedom. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  RECOVA 
Entry  Point:  RECOVA 


Purpose: 

To  recover  the  symmetric  or  asymmetric  f-set  displacements  or  accelerations  if  there  are  omitted  degrees 
of  freedom. 


MAPOL  Calling  Sequence: 

CALL  RECOVA  {  [UA] ,  [PO] ,  [GSUBO(BC)],  NRSET,  [AA] ,  [IFM{BC)]/  SYM, 
[KOOIIIV(BC)],  [KOOU{BC)],  [PFOA(BC)],  [OT]  ); 


[UA] 

Matrix  of  displacements  or  accelerations  in  the  analysis  set  (Input) 

[PO] 

Optional  matrix  of  static  loads  applied  to  omitted  degrees  of  freedom 
(Input) 

[GSX7BO(BC)  ] 

Static  condensation  transformation  matrix  (Input),  where  BC  represents 
the  MAPOL  boimdary  condition  loop  index  number 

NRSET 

Flag  indicating  that  inertia  relief  effects  are  to  be  included 
(Integer,  Input) 

[AA] 

Optional  matrix  of  analysis  set  accelerations  for  inertia  relief  (Input) 

[IFM(BC)] 

Optional  matrix  containing  terms  needed  for  inertia  relief  (Input),  where 
BC  represents  the  MAPOL  boundary  condition  loop  index  number 

SYM 

Optional  symmetry  flag;  =1  if  any  KFF  is  not  S3rmmetric  (Integer,  Input) 

[KOOINVfBC)] 

Matrix  containing  the  inverse  of  KOO  for  symmetric  stiffness  matrices  or 
the  lower  triangular  factor  of  KOO  for  asymmetric  matrices  (Input),  where 
BC  represents  the  MAPOL  boundary  condition  loop  index  number 

[KOOU(BC)] 

Optional  matrix  containing  the  upper  triangular  factor  of  KOO  for  as3nn- 
metric  stiffiiess  matrices  (Input),  where  BC  represents  the  MAPOL  boimd¬ 
ary  condition  loop  index  number 

[PFOA(BC)] 

The  partitioning  vector  splitting  the  free  degrees  of  freedom  into  the 
analysis  set  and  the  omitted  degrees  of  freedom  (Input),  where  BC  repre¬ 
sents  the  MAPOL  boundaiy  condition  loop  index  number 

[UF] 

Matrix  containing  the  displacements  or  accelerations  for  the  free  degrees 
of  freedom  (Output) 

Apphcation  Calling  Sequence: 

None 

Method: 

The  RECOVA  module  begins  by  checking  if  the  PO  argument  is  nonblank.  If  so,  the  displacements  at  the 
omitted  degrees  of  freedom  due  to  the  loads  at  the  omitted  degrees  of  freedom,  uoo,  are  computed.  These 
computations  depend  on  whether  inertia  relief  and/or  asymmetric  stiffnesses  exist.  If  inertia  relief  is 

required  (NRSET  >  0)  the  loads  on  the  omitted  DOF’s  are  modified  using  the  IFM  matrix  and  the  analysis 
set  accelerations,  AA;  both  of  which  must  be  input: 

[PO]  =  [PO]  -  [IFM] [AA] 
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The  UOO  terms  are  then  computed  from  the  inverted  KOO  terms  based  on  the  SYM  flag;  with  the  symmetry 
flag  indicating  whether  the  general  or  symmetric  forward  backward  substitution  is  used: 

[troo]  =  [KOO]”^[PO]  using  Forward  Backward  Substitution 

Finally,  the  omitted  displacements,  UO,  are  computed  from: 

[UO]  =  [GSUBO] [UA]  +  [UOO] 

Note  that  the  module  assumes  that  the  correct  set  of  KOOINV,  KOOU,  IFM,  AA,  ^d  PO  matrices  are 
supplied  to  match  the  SYM  and  UPSET  flags.  If  the  PO  argument  is  omitted  from  the  calhng  sequence, 
the  UO  terms  are  computed  directly  from: 

[UO]  =  [GSUBO]  [UA] 

with  the  GSUBO  argument  required  to  perform  the  computation.  Note  that  these  computations  are  the 
same  irrespective  of  the  nrset  flag.  When  UO  is  complete,  the  module  merges  the  computed  UO  terms 
with  the  suppUed  UA  terms  to  form  the  UF  output. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  SAERO 

Entry  Point:  SAERO 

Purpose: 

Tb  solve  the  trim  equation  for  steady  aeroelastic  trim  analyses  and  to  compute  the  rigid  and  flexible 
stability  coefficients  for  steady  aeroelastic  analyses  and  the  aerodynamic  effectiveness  constraints  for 
constrained  optimization  steady  aerodynamic  analyses. 

MAPOL  Calling  Sequence: 

CALL  SAERO  (  NITER,  BCID,  MINDEX,  SUB,  SYM,  QDP,  STABCP,  BGPDT{BC), 

[LHSA(BC,SUB)],  [RHSA(BC,SUB) ] ,  [AAR],  [DELTA(SUB) ] ,  [PRIGID] , 


[R33], 

CONST,  AEFLG(SXJB),  [AARC],  [DELC]  ); 

NITER 

Design  iteration  number  (Integer,  Input) 

BCID 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

HXNDEX 

Mach  number  index  for  the  current  subscript  value.  (Integer,  Input) 

SUB 

Subscript  number  of  SAERO  subcases  considered  in  this  call 
(Integer,  Input) 

SYM 

The  symmetry  flag  for  the  current  SAERO  subcases  (Integer,  Input) 

QDP 

Dynamic  pressure  associated  with  the  current  subscript  (Real,  Input) 

STABCF 

Relation  of  rigid  stability  coefficient  data  (Input) 

BGPDT(BC) 

Relation  of  basic  grid  point  coordinate  data  (Input),  where  BC  represents 
the  MAPOL  boundary  condition  loop  index  number 

[LHSA(BC,SUB)] 

Matrix  of  modified  inertia  coefficients  (Input),  where  BC  .represents  the 
MAPOL  boundary  condition  loop  index  number 

[RHSA(BC,SUB)] 

Matrix  of  apphed  load  vectors  reduced  to  the  r-set  (Input),  where  BC  rep¬ 
resents  the  MAPOL  boundaiy  condition  loop  index  number 

[AAR] 

Matrix  of  acceleration  vectors  (Output) 

[  DELTA  (SX}B)] 

Matrix  of  configuration  parameters  (Output) 

[PRIGID] 

Rigid  load  matrix  (Input) 

[R33] 

Reduced  rigid  body  mass  matrix  (Input) 

CONST 

Relation  of  constraint  values  (Input) 

AEFLG(BC) 

The  logical  flag  denoting  presence  of  aeroelastic  constraints 
(Logical,  Output),  where  BC  represents  the  MAPOL  boundary  condition 
loop  index  number 

[AARC] 

Matrix  of  structural  accelerations  due  to  unit  configuration  parameters 
for  use  in  sensitivity  evaluation  (output) 

[DELC] 

Matrix  of  "imit"  flight  configuration  parameters  used  to  generate  the 
AARC  accelerations  (output) 
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Application  Calling  Sequence: 

None 

Method: 

The  module  begins  by  bringing  into  memory  the  CASE  entries  associated  with  SAERO  subcases  inthe 
current  boundSy  condition.  Then,  the  stabcf  relation  is  read  mto  memory  for 
value.  The  TRIM  relation  is  read  for  aU  entries  that  have  the  current  subcnpt  value  and  other  trim  data 
from  AEROS,  CONEFFS,  and  CONLINK  are  also  read  into  memory. 

Then  an  evaluation  of  the  trim  data  is  done  to  determine  the  number  of  trim  subcases  that  will  be  solved 

^"Mspass(forthecurrentsubscript).TheAROCHEutmtyisusedtoev^uatetheSUPOR^^^^^ 

to  ensure  (again)  that  it  satisfies  the  requirements  of  the  TRIM  solver  ^d  to  get  &e  names  and  D(D 
of  the  supported  degrees  of  freedom.  Then,  after  creating  needed  scratch  entities,  the  grand  loop  on  the 

trim  subcases  begins. 

Each  trim  subcase  must  be  solved  separately  because  of  the  options  for  control  effectiveness  ^d  control 
linVir.fr  The  first  step  is  to  determine  which  TRIM  entries  are  associated  with  the  canent  subcase  (note 
aU  are  associated  with  the  current  subscript).  Once  the  trim  id  of  the  current  case  is  ^own,  fte  ^SE 
relation  data  are  searched  to  determine  the  subcase  number  (1  to  n  over  ^1  SAERO  entnes  m  CASE  for 
each  BC).  Then  the  arolmk  routine  is  called  to  assemble  a  linkmg  matrix  of  control  effectiveness  factors 
and  UnVing  relationships  for  the  current  subscript  such  that: 

{8}  =  [TLINK]  *  DELRED 

where  the  DELRED  matrix  is  reduced  to  only  the  active  trim  parameters  md  the  effertiveness  factors 
have  been  included.  Then  the  rigid  and  flexible  loads  are  hit  with  the  linking  matrix  to  reduce  the 
problem  to  the  relevant  configuration  parameters: 

P2RED  =  P2  *  TLINK 


RESRED  =  RHS  *  TLINK 

P2RED  and  RHSRED  contain  one  row  for  each  structural  acceleration  and  one  column  for  each  label  on 
the  trim  entry  This  means  that  the  total  number  of  stability  parameters  (either  fixed  or  free)  is  the 
number  of  columns  in  P2  and  RHS.  Further,  the  order  of  the  parameters  is  the  order  given  on  the  TRIM 

tuples. 

Now  the  trim  equations  can  be  assembled.  From  the  input,  we  have  the  relationship 


LHSff  LHSj,^- 

■^froo]  ^ 

■RHSf^  RHS^/ 

-DEL^- 

LHS„f  LHS,^ 

^^^^known 

_RHS,„  RHS„3 

DEL^ 

Where: 

Represents: 

F+K 

Niimbfir  of  SUPORT  point  DOFs 

F 

Set  of  free  accelerations,  ar 

K 

Set  of  known(FlXED)  accelerations,  AR 

U+S 

Number  of  AERO  parameters 

U 

Set  of  unknown  parameters 

s 

Set  of  set(FIXED)  parameters 

These  equations  must  be  rearranged  to  get  free  accelerations  and  unknown  delta’s  on  the  same  side  of 
the  equation: 


■^free' 

-RHS 

DEL 

U 

DELg 

and  we  must  handle  the  degenerate  case  where  all  accelerations  or  all  delta’s  are  known. 

Following  rearrangement  of  the  equations,  the  unknowns  are  solved  for  in  the  ARTRMS/D  routine. 
First  the  rigid  masses  and  loads,  P2RED  and  mrr  are  used  to  obtain  the  rigid  trim  and  then  the  flexible 
inputs  RHSRED  and  LHS  are  used  for  the  ’’real"  solution. 

Then,  the  flexible  results  are  unscrambled  and  the  rigid  body  accelerations  (either  input  on  the  TRIM 
or  output  from  the  solution  of  the  above)  are  stored  on  the  AAR  matrix  and  the  same  is  done  with  the 
trim  parameters  after  the  TLINK  matrix  is  used  to  recover  the  full  vector  from  the  reduced  set.  Then 
the  results  for  the  rigid  and  flexible  trim  are  printed. 

Only  if  the  print  is  requested  or  if  constraints  are  applied  are  the  stability  coefficients  computed.  These 
data  are  recomputed  in  each  subcase  because  the  effectiveness  terms  affect  the  stability  derivative 
outputs.  The  ARSCFS/D  module  is  called  to  compute  the  flexible  data  from  the  forces  on  the  support 
degrees  of  freedom  due  to  the  unit  configuration  parameters: 

[F]  =  [MRR]  [LHS]''^[RHS] 

The  P2  matrix  contains  the  same  information  for  the  rigid  aerodynamic  loads  (computed  in  the  MAPOL 
sequence).  These  data  are  then  normalized  and  the  stability  coefficient  table  stored  into  memory.  Once 
complete,  the  stability  coefficient  table  is  printed  using  the  effectiveness  factors  and  linking  terms  to 
assemble  the  "dependent”  coefficients  and  factor  all  coefficients  according  to  the  user  input. 

Finally,  using  the  in-core  table  of  derivatives,  the  ARGONS /D  submodule  is  called  to  evaluate  the 
constraints  for  the  current  subcase.  These  constraints  are  evaluated  from  the  stability  coefficient  table 
but,  to  prepare  for  eventual  sensitivity  computations,  the  additional  outputs  AEFLG,  AARC  and  DELC  are 
needed.  The  first  is  a  logical  flag  to  indicate  to  the  MAPOL  sequence  that  the  AARC  and  DELC  matrices 
are  full.  The  aarc  matrix  and  DELC  matrix  contain  one  or  more  columns  for  each  constraint  (appended 
in  the  order  the  constraints  are  evaluated).  The  AARC  contains  the  accelerations  of  the  support  DOFs 
due  to  the  unit  configuration  parameter  vectors  in  delc.  This  pair  of  matrices  will  allow  the  computation 
of  the  derivative  of  the  accelerations  due  to  the  unit  parameters  which  is  an  essential  ingredient  in  the 
sensitivity  computation. 

For  lift  effectiveness  constraints 

AARC  -  1  column  due  to  unit  ALPHA 

DELC  - 1  column  containing  a  unit  ALPHA  with  all  others  0.0 
For  aileron  effectiveness  constraints 

aarc  -  2  columns;  the  first  for  unit  SURFACE  rotation  and  the  second  for  unit  roll  rate  (PRATE). 
DELC  -  2  columns  containing  a  unit  rotation  of  the  named  SURFACE  and  the  second  a  unit  PRATE 
For  stability  coefficient  constraints  (dconscf) 

AARC  - 1  column  due  to  unit  PARAMETER  where  PARAMETER  is  that  named  on  the  constraint  entry 
DELC  - 1  column  containing  a  unit  PARAMETER  with  all  others  0.0 
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DCONTKM  are  evaluated  at  this  time,  but  do  not  require  any  pseudodisplacements  for  sensitmty 
evaluation.  The  pseudodisplacements  are  those  which  arise  due  to  the  unit  accelerations  that  arise  due 
to  unit  configuration  parameters. 


After  the  stability  coefficients  (and  constraints)  are  computed 
results  are  printed  and  the  module  repeats  the  entire  process 
with  the  current  suBscript.  Then  the  module  terminates. 


and  printed,  the  rigid  and  flexible  trim 
for  all  the  subcases  that  are  associated 


Design  Requirements: 
None 


Error  Conditions: 
None 
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Engineering  Application  Module :  S AERODRV 


SARODR 


MAPOL  director  for  steady  aeroelastic  analyses. 

MAPOL  Calling  Sequence: 

CALL  SAERODRV  (BCID,  SUB,  LOOP,  MINDEX,  SYM,  MACH,  QDP,  PRINT  ); 

BCID  User  defined  boundaiy  condition  identification  number  (Integer,  Input) 

SUB  Current  Mach  number  subscript  number  (Integer,  Input) 

LOOP  Logical  flag  indicating  whether  another  subscript  is  required  to  complete 

the  set  of  all  subcases  (Logical,  Output) 

MINDEX  Mach  number  index  associated  with  the  current  subscript. 

(Integer,  Output) 

SYM  SYMmetry  flag  for  the  current  subscript.  (Integer,  Output) 

=  1  symmetric 
=  -1  Antisymmetric 

MACH  Mach  number  associated  with  the  current  subscript  (Real,  Output) 

QDP  Dynamic  pressure  associated  with  the  current  subscript  (Real,  Output) 


PRINT 


Optional  print  flag  indicating  that  the  summaiy  of  trim  cases  associated 
with  the  current  pass  (subscript)  is  to  be  printed  to  the  standard  output. 
(In  the  standard  sequence,  PRINT  is  used  only  during  analysis  not  during 
sensitivity  analysis)  (Optional,  Integer,  Input) 


None 

Method: 


First  the  CASE  relation  is  read  to  determine  the  TRIM  ids  and  SYMmetries  of  all  SAERO  cases  in  the 
current  boundary  condition.  If  any  exist,  the  TRIM  relation  is  opened  and  read  into  memory.  Each  trim 
entry  referenced  in  CASE  is  then  compressed  into  a  format  containing  the  TRIM  id,  Mach  number, 
dynamic  pressure,  trim  type,  Mach  number  index,  subscript  and  subcase  id. 

Once  these  data  are  collected,  the  CASE  tuples  read  into  memory  are  looped  over  to  choose  which  TRIM 
cases  are  to  be  analyzed  for  this  subscript  value.  There  are  four  steps  in  choosing  the  proper  trim  cases: 

(1)  Take  the  first  saero  subcase  in  CASE  that  has  not  been  done  on  an  earlier  pass  —  cases  already 
analyzed  will  reference  trims  with  a  "subscript"  value  that  is  not  "null"  (uninitialized)  and  that  is 
less  than  the  current  value  of  SUB  —  on  the  first  design  iteration  all  subscript  values  will  be  "null" 

(2)  Once  the  parent  case  is  known,  choose  that  case  and  all  others  with  the  same  Mach,  QDP  and 
TRMTYP 


(3)  Update  the  "subcript"  attribute  in  TRIM  to  mark  all  the  cases  that  are  being  processed.  Also 
load  the  SUBID  to  assist  in  re-merging  the  answers  into  CASE  subcase  order 

(4)  Check  if  any  more  saero  subcases  need  to  be  processed  and  set  the  "loop"  flag 
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After  these  steps  have  been  completed,  if  the  PRINT  flag  is  nonzero,  a  summary  of  the  selected  TRIMs 
is  printed  to  the  output  file. 

Design  Requirements: 

1.  The  TRIM  relation  is  assumed  to  contain  NOLL  values  for  subscrpt  on  the  first  subscript  of  the  first 
design  iteration  (for  optimize  boundary  conditions)  and  for  the  first  subscript  of  all  ANALYZE  boundary 

conditions. 

Error  Conditions: 

None 
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Engineering  Application  Module:  SAEROMRG 


Entry  Point:  SAROMR 


Purpose: 

Merges  the  static  aero  results  for  each  subscript  (stored  in  the  matrix  [matsub]  )  into  the  [matout] 
matrix  in  case  order  rather  than  subscript  order  for  the  BC’th  boundary  condition. 


MAPOL  Calling  Sequence: 

CALL  SAEROMK6  (  BCXD, 
BCID 
SUB 

[MATOUT] 

[MATSUB] 


SUB,  [MATOUT] ,  [MATSUB]  )  ; 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

Current  Mach  number  subscript  (Input,  Integer) 

Merged  output  matrix  reordered  to  be  in  CASE  order  for  the  current 
boundary  condition  (Input  and  Output) 

Generic  input  matrix  containing  data  for  the  current  subscript  value  in 
TRIM  id  order  of  TRIM  cases  associated  with  the  current  subscript  (Input) 


Application  Calling  Sequence: 
None 


Method: 

First  the  case  relation  is  read  to  retrieve  the  trim  id's  for  the  SAERO  subcases  in  the  current  boundary 
condition.  The  the  TRIM  relation  is  read  to  obtain  the  subcase  numbers  associated  with  each  trim  id 
having  the  current  SUBscript  value. 

Then  the  matsub  and  matout  matrices  are  opened.  If  matout  is  uninitialized  or  if  SUB  =  1,  it  is 
initialized  (flushed  and  the  number  of  rows,  precision  and  form  set  to  those  of  MATSUB.  If  matout  already 
exists  and  has  data  in  it,  a  scratch  matrix  is  created  to  hold  the  final  merged  data. 

For  each  SAERO  CASE  entry  for  the  current  botmdary,  the  TRIM  data  are  searched  to  determine  the 
subscript  number  associated  with  the  subcase.  If  the  subscript  is  less  than  SUB,  a  column  from  MATOUT 
will  be  taken  (it  was  stored  there  on  an  earlier  pass).  If  the  subscript  is  equal  to  SUB,  it  will  be  stored 
on  the  output  matrix  from  MATSUB.  If  greater  than  SUB,  it  is  ignored  till  later  passes. 

Once  a  column  is  identified  as  active  in  MATSUB  (PGAA  indicates  active  and  subscript  =  SUB),  an 
additional  check  is  made  to  see  if  the  column  is  active  in  PGUA.  Only  those  columns  that  are  active  in 
PGUA  are  copied  to  MATOUT.  This  filtering  is  done  to  limit  the  amoxint  of  computational  effort  in  the 
stress,  strain  and  displacement  constraint  sensitivity  computations  that  proceed  using  the  MATOUT 
matrix.  The  MATSOT  coliimns  that  are  active  due  to  DCONTRM  constraints  are  no  longer  needed  as  these 
sensitivities  are  assumed  to  have  been  computed  already  in  the  AEROSENS  modxde. 

Once  the  final  matrix  is  formed,  if  MATOUT  had  had  data  in  it,  the  name  of  the  scratch  matrix  that  was 
loaded  is  switched  with  that  of  MATOUT.  The  scratch  entity  is  then  destroyed. 
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Design  Requirements: 

1.  The  assumption  is  that  each  matsub  matrix  contains  the  results  from  the  "suB"th  subscript  value  in 
the  order  the  trim  id’s  for  that  sub  appear  in  the  TRIM  relation. 

2.  The  same  MATOUT  matrix  must  be  passed  into  the  AROSNSMR  module  on  each  call  since  the  columns 
associated  with  earlier  subscript  values  are  read  from  MATOUT  into  a  scratch  entity.  The  merged  matrix 
that  results  then  replaces  the  input  MATOUT. 

3.  The  AEROSENS  module  is  called  upstream  of  the  AROSNSMR  module  to  process  active  DCOMTRM 
constraints  for  the  current  subscript.  Thus,  those  columns  that  are  active  only  for  dcontrm  constraints 
may  be  filtered  out  for  the  downstream  processing  of  stress,  strain  and  displacement  constraints. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module;  SCEVAL 

Entry  Point:  SCEVAL 

Purpose: 


lb  compute  the  stress  and/or  strain  constraint  values  for  the  statics  or  steady  aeroelastic  trim  analyses 
in  the  current  boundary  condition. 

MAPOL  Calling  Sequence: 

CALL  SCEVAL  (  NITER,  BCID,  [UG(BC)],  [SMAT] ,  [NLSMAT] ,  SMATCOL,  NLSMTCOL, 

TREE,  TREFD,  [GLBSIG] , [NLGLBSIG] ,  CONST,  DSCFLG  ) ; 


NITER 

Design  iteration  number  (Integer,  Input) 

BCID 

User  defined  boundary  condition  identification  number  (Integer,  Input) 

[UG(BC)] 

The  matrix  of  global  displacements  for  all  static  applied  loads  in  the  cur¬ 
rent  boundary  condition  (Input),  where  BC  represents  the  MAPOL  bound¬ 
ary  condition  loop  index  number. 

[SMAT] 

Matrix  entity  containing  the  linear  portion  of  the  sensitivity  of  the  stress 
and  strain  components  to  the  global  displacements  (Input) 

[NLSMAT] 

Matrix  entity  containing  the  nonlinear  portion  of  the  sensitivity  of  the 
stress  and  strain  components  to  the  global  displacements  (Input) 

SMATCOL 

Relation  containing  matrix  SMAT  column  information  (Character,Input) 

NLSMTCOL 

Relation  containing  matrix  NLSMAT  column  information  (Character, Input) 

TREF 

Unstructured  entity  containing  the  linearly  designed  element  reference 
temperatures  (Input) 

TREFD 

Unstructured  entity  containing  the  nonlinearly  designed  variable  ele¬ 
ment  reference  temperatures  (Input) 

[GLBSIG] 

Matrix  of  stress/strain  components  for  all  the  applied  linearly  designed 
stress  constraints  for  the  current  boundary  condition  (Output) 

[NLGLBSIG] 

Matrix  of  stress/strain  components  for  all  the  applied  nonlinearly  de¬ 
signed  stress  constraints  for  the  current  boundaiy  condition  (Output) 

CONST 

Relation  of  constraint  values  (Const) 

DSCFLG 

The  discipline  flag  (Integer,  Input) 

=  0  statics 

>  0  static  aeroelasticity 

Application  Calling  Sequence: 

None 

Method: 

The  SCEVAL  module  begins  by  determining  if  there  are  any  stress  constraints  applied  and  any  user 
functions  which  require  element  response  functions.  If  any  are  found,  execution  continues. 

First  the  CASE  relation  is  read.  Then,  if  the  call  is  associated  with  saero  disciplines,  the  trim  relation 
is  read  to  associate,  for  each  subcase,  the  subcase  id  and  the  subscript  id.  Then  an  in-core  table  is  formed 
that  contains,  for  the  subcases  in  this  boundary  condition  the  DISFU^G,  SUBSCRIPT,  and  THERMID.  The 
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latter  is  for  thermal  load  corrections  to  the  stresses  and  strains.  If  any  thermal  load  cases  were  found, 
the  GRIDTEMP  and  tref  entities  are  opened. 

If  the  current  boundary  condition  is  the  first  with  stress  or  strain  constraints,  the  running  constraint 
type  count  variables  are  reinitialized  for  the  current  design  iteration.  This  type  count  provides  a  link 
between  the  ACTCON  print  of  design  constraints  and  the  debug  prmt  option  supported  by  the  sceval 
module.  If  any  thermal  loads  exist  for  the  current  boundary  condition,  the  GRIDTEMP,  TREF  and  TREFD 
entities  are  brought  into  memory  to  be  available  for  the  computation  of  the  stress-free  thermal  stram 
correction  to  the  element  stresses.  Once  these  preparations  have  been  made,  the  SMAT  and  nlsmat 
matrices  of  stress/strain  sensitivities  and  the  glbsig  and  nlglbsig  matrices  are  opened  and  the 
GLBSIG  and  NLGLBSIG  matrices  are  positioned  to  the  proper  columns  to  pack  additional  stress/stram 
components.  Note  that  the  glbsig  and  nlglbsig  matrices  store  all  the  columns  associated  with  the 
current  boundary  condition  since  they  are  required  for  the  constraint  sensitivity  computations. 

Finally,  the  UG  matrix  of  global  displacements  is  opened.  For  each  column  in  the  UG  matrix,  the  matrix 
products 

[GMA]  =  [SMAT]  {UG}  and  [NLGMA]  =  [NLSMAT]  {UG} 

are  calculated  to  obtain  the  component  stress  or  strain  values  for  linearly  designed  elements  and 
nonlinearly  designed  elements,  respectively.  Having  calculated  and  stored  in  core  these  values,  the 
element  dependent  constraint  evaluation  routines  are  called  to  process  each  constraint.  Note  that  the 
order  in  which  the  element  routines  are  called  must  be  the  same  as  the  order  the  SMAT  and  NLSMAT 
columns  were  formed.  That  order  is: 

1.  Bar  elements,  BARSC  (Using  both  [GMA]  and  [nlgma]  ) 

2.  Isoparametric  quadrilateral  membrane  elements,  QDISC  (Using  [GMA]  only) 

3.  Quadrilateral  bending  plate  elements,  QD4  sc  (Using  both  [gma]  and  [nlgma]) 

4.  Rod  elements,  RODSC  (Using  [GMA]  only) 

5.  Shear  panels,  SHRSC  (Using  [gma]  only) 

6.  Triangular  bending  plate  elements,  TR3SC  (Using  both  [GMA]  and  [NLGMA] ) 

7.  Triangular  membrane  elements,  trmsC  (Using  [gma]  only) 

On  the  first  pass  through  the  element  dependent  routines,  all  the  xxaexEST  tuples  (i.e.,  RODEST  and 
trmemest)  with  nonzero  stress/strain  constraint  flags  are  retrieved  from  the  data  base.  For  subsequent 
passes,  this  information  is  used  directly  from  core.  Each  constraint  is  evaluated  in  turn  with  the  stress 
components  modified  by  the  thermal  stress  correction  if  Hie  displacement  field  includes  tiiermal  strain 
effects.  The  CONST  relation  is  loaded  with  one  tuple  for  each  constraint  as  they  are  processed.  When  all 
the  constraints  have  been  evaluated  for  the  current  loading  condition,  the  adjusted  linear  design 
variable  and  r.nr.1inpar  design  variable  stress/strain  constraint  terms  are  packed  to  the  GLBSIG  and 
NLGLBSIG  matrices. 

The  element  stress  and  strain  responses  which  are  required  by  any  user  function  constraints  are  also 
computed  in  this  module.  Those  response  values  are  stored  into  a  relation  entity  to  be  used  by  user 
function  evaluation  utilities. 
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Design  Requirements: 

1.  The  SMAT  (or  NLSMAT),  GRIDTEMP  and  TREF  (or  TREFD )  entities  must  exist. 

2.  The  CASE  relation  must  be  complete  from  SOLOTION. 

Error  Conditions: 

1.  A  zero  material  allowable  may  cause  division  by  zero  in  the  computation  of  some  of  the  constraints. 


254 


Engineering  Application  Module;  SOLUTION 
Entry  Point:  SOLUTION 


Purpose: 

To  interpret  the  solution  control  packet. 


MAPOL  Calling  Sequence: 

r-aT.T.  SOLUTION  {  NDMOPTBC,  NBNDCOND,  K6ROT,  MPS,  MPE,  OCS,  OCE,  FSDS,  FSDE, 
MAXITER,  MOVLIM,  WINDOW,  OCMOVLIM,  ALPHA, CNVRGLIM, 

NRFAC,  EPS,  FDSTEP  ); 


NUMOPTBC 

NBNDCOND 

K6ROT 

MPS 

MPE 

OCS 

OCE 


Number  of  optimization  boimdary  conditions  (Integer,  Output) 

Thtal  number  of  optimization  and  analysis  boundary  conditions 
(Integer,  Output) 

Stifbiess  value  for  plate  element  "drilling"  degrees  of  freedom 
(Reed,  Output) 

The  first  iteration  to  use  math  programming  (Integer,  Output) 
The  last  iteration  to  use  math  programming  (Integer,  Output) 
The  first  iteration  to  use  optimality  criteria  (Integer,  Output) 
The  last  iteration  to  use  optimality  criteria  (Integer,  Output) 


FSDS 


The  first  iteration  to  use  FSD  (Integer,  Output) 


FSDE 

MAXITER 

MOVLIM 

WINDOW 


OCMOVLIM 

ALPHA 

CNVRGLIM 

NRFAC 


The  last  iteration  to  use  FSD  (Integer,  Output) 

The  maximum  number  of  allowable  iterations  (Integer,  Output) 

Limit  on  how  much  a  design  variable  can  move  for  this  iteration  in  using 
math  programming  (Real,  Output) 

The  window  around  the  zero  in  which  the  MOVLIM  bound  is  overridden  to 
allow  the  local  variable  to  change  sign.  If  WINDOW  =  0.0,  the  local  vari¬ 
able  may  not  change  sign.  If  window  is  nonzero,  the  half  width  of  a  band 
around  zero,  EPS  is  computed 

EPS  =  WINDOW/100  *  MAX  (  ABSfTMIN),  ABS(TMIN)  ) 

If  the  local  variable  falls  within  the  band,  the  new  minimum  or  maximum 
for  the  current  iteration  is  changed  to  lie  on  the  other  side  of  zero  from 
the  local  variable.  The  bandwidth  EPS  is  a  percentage  of  the  larger  of 
TMAX  or  TMIN  where  WINDOW  specifies  the  percentage.  (Real,  Output) 

Limit  on  how  much  a  design  variable  can  move  for  this  iteration  in  using 
optimality  critera  (Real,  Output) 

Exponential  move  limit  for  the  FSD  algorithm  (Real,  Output) 

Relative  percent  change  in  the  objective  function  that  indicates  approxi¬ 
mate  problem  convergence  (Real,  Output) 

Determines  the  minimum  number  of  retained  constraints  equal  to 
NRFAC*NDV  (Real,  Output) 
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EPS 


A  second  criteria  for  constraint  retention.  All  constraints  greater  than  or 
equal  to  EPS  will  be  retained  (Real,  Output) 

FDSTEP  Relative  design  variable  increment  for  finite  difference  computations 

(RealjOutput) 

Application  Calling  Sequence: 

None 

Method: 

The  SOLUTION  module  interprets  the  solution  control  statements  and  loads  the  resultant  information 
to  the  CASE  relation.  On  completion  of  the  routine,  the  total  number  of  all  boundary  conditions,  the 
nnmhpr  of  analysis  boundary  conditions  and  the  user’s  optimization  strategy  are  output  to  the  executive 
sequence  to  direct  the  MAPOL  execution  path. 

Design  Requirements: 

1.  A  Solution  Control  packet  must  be  included  in  the  input  data  stream. 

Error  Conditions: 

1.  Syntax  errors  and  inconsistent  or  illegal  solution  control  requests  are  flagged  and  the  execution  is 
terminated. 
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Engineering  Application  Module:  SPLINES 
Entry  Point:  SPLINE 


Purpose: 

Generates  the  interpolation  matrix  that  relate  displacements  and  forces  between  the  structural  and 
steady  aerodynamic  MODELS. 

MAPOL  Calling  Sequence: 

CALL  SPLINES  (  GSIZEB,  6E0MSA/  AECOMPS/  AEROS/  [6TKG] ,  [GSTKG]  ) ; 

The  number  of  degrees  of  freedom  in  the  set  of  all  structural  GRID  and 
SCALAR  points  (Integer,  Input) 

A  relation  describing  the  aerodynamic  boxes  for  the  steady  aerodynamics 
model.  The  location  of  the  box  centroid,  normal  and  pitch  moment  axis 
are  given.  It  is  used  in  splining  the  aerodjnamics  to  the  structure  and  to 
map  responses  back  to  the  aerodynamic  boxes  (Input) 

A  relation  describing  aerodynamic  components  for  the  steady  aerodynam¬ 
ics  model.  It  is  used  in  splining  the  aerodynamics  to  the  structural  model 
(Input) 

A  relation  containing  the  definition  of  the  aerodynamic  coordinate  system 
(Input) 

The  matrix  of  splining  coefficients  relating  the  aerodynamic  pressures  to 
forces  at  the  structural  grids  (Output) 

The  matrix  of  splining  coefficients  relating  the  structoal  displacements 
to  the  streamwise  slopes  of  the  aerodynamic  boxes  (Output) 

Application  Calling  Sequence: 

None 

Method: 

All  the  SPLINEI,  SPLINE2  and  attach  data  are  read  and  those  associated  with  the  steady  aerodynamic 
model  as  described  by  the  aecomps  entity  are  used  to  assemble  a  hst  of  aerodynamic  boxes  and 
structural  grids  for  each  spline.  The  GEOMSA  relation  is  used  to  obtain  the  basic  coordinates  of  the 
aerodynamic  boxes  and  the  B6PDT  relation  is  used  to  obtain  the  locations  of  the  structural  grids.  The 
spline  matrix  consisting  of  two  columns  (displacement  and  slope)  for  each  aerodynamic  box  and  6  rows 
for  each  structural  grid  is  then  assembled  for  the  aerodynamic  boxes  and  structural  grids  attached  to 
the  spline. 

The  spline  matrix  is  then  expanded  to  include  two  columns  for  each  aerodynamic  box  in  the  steady 
aerodynamic  model  and  GSIZEB  rows.  It  is  then  split  into  two  pieces  with  each  odd-numbered  column 
(displacement)  merged  with  previously  processed  splines  to  form  the  GTKG  matrix  and  each  even 
niimbered  (slope)  column  merged  to  form  GSTKG.  The  process  is  repeated  until  all  splines  have  been 
completed.  The  final  matrices  are  returned  to  the  MAPOL  sequence. 


GSIZEB 

GEOMSA 

AECOMPS 

AEROS 

[GTKG] 

[GSTKG] 
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Error  Conditions: 

1.  Each  aerodynamic  box  may  appear  on  only  one  SPLINEI,  SPLINE2  or  attach  entry  although  not  all 
boxes  need  appear.  Missing  boxes  will  not  influence  the  aeroelastic  response. 

2.  Missing  structural  grids  or  aerodynamic  elements  appearing  on  the  spline  definitions  will  be  flagged. 
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Engineering  Application  Module:  SPLINEU 

Entry  Point:  SPLINE 

Purpose: 

Generates  the  interpolation  matrix  that  relate  displacements  and  forces  between  the  structural  and 
unsteady  aerodynamic  models. 

MAPOL  Calling  Sequence: 

r-aT.T.  SPLIMEU  (  GSIZEB,  6E0MUA,  AECOMPD,  AERO,  [UGTKG]  ) ; 

The  number  of  degrees  of  freedom  in  the  set  of  all  structural  GRID  and 
SCALAR  points  (Integer,  Input) 

A  relation  describing  the  aerodynamic  boxes  for  the  unsteady  aerodynam¬ 
ics  model.  The  location  of  the  box  centroid,  normal  and  pitch  moment  axis 
are  given.  It  is  used  in  splining  the  aerodynamics  to  the  structure  and  to 
map  responses  back  to  the  aerodynamic  boxes  (Input) 

A  relation  describing  aerodynamic  components  for  the  vmsteady  aerody¬ 
namics  model.  It  is  used  in  splining  the  aerodynamics  to  the  structural 
model  (Input) 

A  relation  containing  the  definition  of  the  aerodynamic  coordinate  system 
(Input) 

The  matrix  of  splining  coefficients  relating  the  aerodynamic  pressures  to 
forces  at  the  structural  grids  and  relating  the  structural  displacements  to 
the  streamwise  slopes  of  the  aerodynamic  boxes  (Output) 


GSIZEB 

GEOMUA 

AECOMPU 

AERO 

[UGTKG] 


Application  Calling  Sequence: 

None 

Method: 

All  the  SPLINEI,  SPLXIIE2  and  ATTACH  data  are  read  and  those  associated  with  the  unsteady 
aerodynamic  model  as  described  by  the  aecompu  entity  are  used  to  assemble  a  list  of  aerodynamic  boxes 
and  structural  grids  for  each  spline.  The  GEOMUA  relation  is  used  to  obtain  the  basic  coordinates  of  the 
aerodynamic  boxes  and  the  bgpdt  relation  is  used  to  obtain  the  locations  of  the  structural  grids.  The 
spline  matrix  consisting  of  two  columns  (displacement  and  slope)  for  each  aerodynamic  box  and  6  rows 
for  each  structural  grid  is  then  assembled  for  the  aerodynamic  boxes  and  structural  grids  attached  to 
the  spline. 

The  spline  matrix  is  then  expanded  to  include  two  colxmms  for  each  aerodynamic  box  in  the  unsteady 
aerodynamic  model  and  GSIZEB  rows.  It  is  then  merged  with  previously  processed  splines.  The  process 
is  repeated  until  all  splines  have  been  completed.  The  final  [UGTKG]  matrix  is  returned  to  the  MAPOL 
sequence. 
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Design  Requirements: 

None 

Error  Conditions: 

1.  Each  aerod5Taamic  box  may  appear  on  only  one  SPLINEl,  SPLINE2  or  attach  entry  although  not  all 
boxes  need  appear.  Missing  boxes  will  not  influence  the  aeroelastic  response. 

2.  Missing  structural  grids  or  aerodynamic  elements  appearing  on  the  spline  definitions  will  be  flagged. 
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Engineering  Application  Module:  STEADY 


STEADY 


To  perform  preface  aerodynamic  processing  for  planar  steady  aerodjmamics. 

MAPOL  Calling  Sequence: 

CALL  STEADY  (  MINDEX,  TRIMDATA,  AECOMPS/  GEOMSA/  STABCP,  [AICMAT (MINDEX) ] / 
[AAICMAT(MINDEX)],  [AIRFRC (MINDEX) ] ,  AEROGEOM,  CAROGEOM  ); 


TRIMDATA 


MINDEX  Mach  number  index  for  the  current  pass.  Controls  which  Mach  Num¬ 

ber/symmetry  conditions  will  be  processed  in  this  pass  of  STEADY.  C)ne 
pass  for  each  unique  Mach  number  will  be  performed  with  mindex  incre¬ 
menting  by  one  mtil  trimchek  returns  loop=false  (Input) 

TRIMDATA  A  relation  created  by  trimchek  that  contains  the  description  of  the  TRIM 

entries  for  each  boimdary  condition  and  each  subcase.  Additional  sub¬ 
scripts  have  been  added  to  the  TRIM  data  to  associate  Mach  number  val¬ 
ues  with  MINDEX  subscripts  and  the  input  accelerations  have  been 
normalized  to  be  in  consistent  units  (Input) 

AECOMPS  A  relation  describing  aerodynamic  components  for  the  planar  STEADY 

aerodynamics  model.  It  is  used  in  splining  the  aerodynamics  to  the  struc¬ 
tural  model  (Output) 

GEOMSA  A  relation  describing  the  aerodynamic  boxes  for  the  planar  STEADY  aero¬ 

dynamics  MODEL.  The  location  of  the  box  centroid,  normal  and  pitch  mo¬ 
ment  avis  are  given.  It  is  used  in  splining  the  aerodynamics  to  the 
structure  and  to  map  responses  back  to  the  aerodynamic  boxes  (Output) 

STABCF  A  relation  of  rigid  stability  coefficients  for  unit  configuration  parameters. 

The  rigid  coefficients  are  stored  in  STABCF  and  the  corresponding  distrib¬ 
uted  forces  are  stored  in  AIRFRC.  The  STABCF  relation  is  used  to  pick  the 
appropriate  rigid  loads  from  AIRFRC  when  performing  the  aeroelastic 
trim  as  well  as  for  retrieving  the  RiGiD/DiRECT  stability  coefficients  for 
each  configuration  parameter  (Output) 

[AICMAT  (MINDEX)  ]  Matrix  containing  the  steady  aerodynamic  influence  coefficients  for  sym- 
metric  Mach  numbers  (Output) 

[AAICMAT  (MINDEX)  ]  Matrix  containing  the  STEADY  aerodynamic  influence  coefficients  for  anti- 
SYMmetric  Mach  numbers  (Output) 


AECOMPS 


GEOMSA 


STABCF 


[AICMAT (MINDEX)] 


[AIRFRC (MINDEX)] 


AEROGEOM 


Matrix  containing  the  aerod3mamic  forces  for  unit  configuration  parame¬ 
ters  for  the  current  Mach  number  index.  If  both  SYMmetric  and  antiSYM- 
metric  conditions  exist  for  the  Mach  number,  both  sets  of  configuration 
parameters  will  coexist  in  AIRFRC  (Output) 

An  aerodynamic  geometry  relation  output  only  for  geometry  checking. 
The  "grids"  defined  in  aerogeom  are  "connected"  to  2-node  (RODs)  and  4- 
node  (quads)  elements  in  the  CAROGEOM  in  such  a  way  as  to  emulate  the 
structural  MODEL.  ICE  may  then  be  used  to  punch  an  equivalent  struc¬ 
tural  MODEL  to  allow  graphical  presentation  of  the  steady  aero  model 
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CAROGEOH 


A  aerodynamic  geometry  relation  output  only  for  geometry  checking.  The 
"grids"  defined  in  aerogeom  are  "connected"  to  2-node  (rods)  and  4-node 
(quads)  elements  in  the  carogeom  in  such  a  way  as  to  emulate  the  struc¬ 
tural  MODEL.  ICE  may  then  be  used  to  punch  an  equivalent  structural 
model  to  allow  graphical  presentation  of  the  steady  aero  model 


Application  Calling  Sequence: 

None 

Method: 

The  STEADY  preface  module  performs  initial  aerod3niamic  processing  for  planar  STEADY  aerodynamics. 
It  is  driven  by  the  the  trimdata  relation  and  the  mindex  value. 

On  each  caU,  the  trimdata  relation  is  queried  to  determine  the  MiNDEX’th  Mach  number  and  whether 
symmetric,  antisymmetric  or  both  boundary  conditions  are  to  be  apphed. 

On  the  first  caU  (determined  by  MIIJDEX=1)  the  STEADY  module  computes  the  planar  steady  aerody¬ 
namic  geometry  in  caUs  to  geom.  It  then  processes  the  current  Mach  number  and  stores  the  resultant 
Alc  terms  in  the  aicmat  and/or  aaicmat  entity  (depending  on  the  S5mmetry  options)  and  in  the 
resultant  rigid  forces  in  the  AIRFRC  matrix.  The  STABCP  relation  is  loaded  for  the  current  MINDEX  value 
with  the  symmetric  and  antis3mmetric  stabihty  derivatives  in  the  same  order  that  the  AIRFRC  matrix 
columns  are  loaded.  Hence,  the  STABCF  relation  points  to  the  corresponding  AIRFRC  column. 

Design  Requirements: 

1.  The  STEADY  module  interacts  with  the  executive  in  that  the  MINDEX  parameter  should  be  unique  for 
each  caU  (although  it  need  not  be  monotonicaUy  increasing).  The  mindex  value  must  be  1  on  the  first 
caU  to  ensure  that  the  geometry  processing  is  done. 

Error  Conditions: 

1.  Errors  in  the  steady  aerodynamic  model  specifications  are  flagged. 
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Engineering  Application  Module:  STEADYNP 
Entry  Point:  STDYNP 


Purpose: 

Non-planar  steady  aeroelastic  analysis  preface. 


MAPOL  Calling  Sequence: 

nitT.T.  STEADYNP  {  NONPONLY,  AECOMPS,  GEOMSA,  STABCP,  [AIRFORCE]  ,  AEROGEOM, 
CAROGEOH,  OAGRDLOD  ) ; 


NONPONLY 


AECONPS 

GEOMSA 


A  logical  flag  returned  to  the  MAPOL  sequence  that  is  true  if  the  only  dis¬ 
ciplines  in  the  CASE  relation  are  nonplanar  static  aerodynamics  subcases. 
If  so,  the  MAPOL  sequence  should  terminate  since  there  is  no  further 
steps  to  be  taken  (Output) 

A  relation  describing  aerod3mamic  components  for  the  nonplanar  STEADY 
aerodynamics  model.  (Output) 

A  relation  describing  the  aerodynamic  boxes  for  the  nonplanar  STEMY 
aerodynamics  model.  The  location  of  the  box  centroid,  normal  and  pitch 
moment  axis  are  given  (Output) 


STABCF 


[AIRFORCE] 


AEROGEOH 


CAROGEOM 


OAGRDLOD 


A  relation  of  rigid  stability  coefficients  for  unit  configuration  parameters. 
The  rigid  coefficients  are  stored  in  STABCF  and  the  corresponding  ffistrib- 
uted  forces  are  stored  in  airfrc.  The  STABCF  relation  is  used  to  pick  the 
appropriate  rigid  loads  from  airfrc  when  performing  the  aeroelastic 
trim  as  well  as  for  retrieving  the  rigid/direct  stability  coefficients  for 
each  configuration  parameter  (Output) 

Matrix  containing  the  aerod3mamic  forces  for  unit  configuration  parame¬ 
ters  for  the  highest  Mach  number  used  in  the  set  of  npsaero  subcases  in 
the  Solution  Packet.  If  both  symmetric  and  antisymmetric  conditions  ex¬ 
ist  for  the  Mach  nrimber,  both  sets  of  configuration  parameters  will  coex¬ 
ist  in  AIRFORCE  (Output) 

A  aerodynamic  geometry  relation  output  only  for  geometry  checking.  The 
"grids"  defined  in  AEROGEOM  are  "connected"  to  2-node  (RODs)  and  4-node 
(quads)  elements  in  the  carogeom  in  such  a  way  as  to  emulate  the  struc- 
ttual  model.  ICE  may  then  be  used  to  punch  an  equivalent  structural 
model  to  allow  graphical  presentation  of  the  steady  aero  model 

A  aerodynamic  geometry  relation  output  only  for  geometry  checking.  The 
"grids"  defined  in  AEROGEOM  are  "connected"  to  2-node  (rods)  and  4-node 
(quads)  elements  in  the  carogeom  in  such  a  way  as  to  emulate  the  struc¬ 
tural  model.  ICE  may  then  be  used  to  punch  an  equivalent  structural 
model  to  allow  graphical  presentation  of  the  STEADY  aero  model 

A  relation  containing  the  rigid  forces  and  pressures  for  each  NPSAERO  sub¬ 
case’s  set  of  configuration  parameters  for  the  aerodynamic  elements 
whose  PRESSURE  output  was  requested  in  Solution  Control.  These  consti¬ 
tute  the  "trimmed"  state  of  the  configuration  (Output) 
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Method: 

The  STKASYNP  preface  module  perform  all  the  processing  for  nonplanar  steady  aerodynamics.  It  is 
driven  by  the  the  trim  data  present  in  the  bulk  data  packet  and  the  npsaero  disciplines  in  the  case 
relation.  The  CASE  relation  provides  the  symmetries  while  the  TRIM  relation  provides  the  Mach 
numbers.  Only  if  npsaero  disciplines  are  in  CASE  is  any  processing  done  and  both  TRIM  and  AEROS 
entries  must  be  foimd.  If  only  NPSAERO  cases  are  found  in  CASE,  the  nonponly  flag  is  set  to  TRUE. 

Internally,  one  pass  is  made  over  the  steadynp  module  for  each  distinct  Mach  number  on  the  TRIMs  in 
CASE.  On  each  pass,  the  PASDFN  submodule  is  called  to  determine  the  set  of  all  Mach  numbers  and,  for 
each  Mach  number,  whether  symmetric,  antis3rmmetric  or  both  boundary  conditions  are  to  be  applied. 
Having  determined  all  unique  Mach  numbers,  the  PASSDF  then  determines  the  Mach  number  (in 
numerical  order  lowest  to  highest)  to  be  processed.  A  mindex  value  from  one  to  the  number  of  unique 
Mach  numbers  is  assigned  to  identify  the  pass.  If  the  chosen  Mach  number  is  the  last  one,  a  LOOP  flag 
is  set  to  false  to  tell  the  STEADYNP  that  no  more  passes  are  needed. 

On  the  first  pass,  the  STEADYNP  module  computes  the  nonplanar  STEADY  aerodynamic  geometry  in 
calls  to  GEOM.  On  the  first  and  subsequenct  passes,  it  then  processes  the  cmrent  Mach  number  and 
stores  the  resultant  rigid  forces  due  to  unit  pau-ameters  in  a  scratch  entity.  A  maximum  of  50  Mach  Index 
values  may  be  analyzed  in  a  single  ASTROS  job.  The  STABCF  relation  is  loaded  for  the  current  MiNDEX 
value  with  the  symmetric  and  antisymmetric  stability  derivatives  in  the  same  order  that  the  rigid  force 
matrix  coliomns  are  loaded.  Hence,  the  stabcf  relation  points  to  the  corresponding  airforce  column. 

Once  all  the  AIRFORCE  matrices  for  each  Mach  number  index  are  computed,  the  NPATRM  submodule  is 
called  to  solve  the  "trim"  condition  for  each  subcase.  That  solution  involves  assembling  the  A  vector  from 
the  user’s  TRIM  entry  and  miiltiplying  the  rigid  unit  force  matrix  by  it.  K  any  PRESSURE  requests  are 
in  the  Solution  Control,  the  pressures  and  forces  on  the  appropriate  aerodynamic  boxes  are  loaded  to 
the  OAGRDLOD  relation.  Finally,  the  intermediate  rigid  force  matrices  are  deleted  except  for  the  last  one. 
Its  name  is  exchanged  for  that  of  AIRFORCE  so  that  it  is  available  to  the  MAPOL  sequence  for  user 
manipulation. 


Design  Requirements: 

1.  A  maximum  of  50  imique  Mach  nTombers  may  be  analyzed  in  a  single  run. 


2.  Only  the  last  (highest)  Mach  number’s  rigid  unit  loads  matrix,  AIRFORCE,  is  saved  and  output  to  the 
MAPOL  sequence. 


Error  Conditions: 

1.  Errors  in  the  STEADY  aerodynamic  models  or  TRIM  specifications  are  flagged. 
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Engineering  Application  Module:  TCEVAL 
Entry  Point:  TCEVAL 


PuiT>ose: 

lb  compute  the  current  values  of  thickness  constraints  for  this  optimization  iteration. 

MAPOL  Calling  Sequence: 

CALL  TCEVAL  (  NITER,  NDV,  MOVLIM,  WINDOW,  GLBDES,  LOCLVAR,  [PMINT] , 

[EMTUCT] ,  [PTRANS] ,  TFIXED,  CONST  ) ; 

Design  iteration  number  (Integer,  Input) 

The  number  of  design  variables  (Integer,  Input) 

Move  limit  to  apply  to  the  local  design  variables  (Real,  Input): 

t /MOVLIM  <  t  <  t  *  MOVLIM;  MOVLIM  >  1.0 

The  window  around  the  zero  in  which  the  movlim  bound  is  overridden  to 
allow  the  local  variable  to  change  sign.  If  window  =  O.O,  the  local  vari¬ 
able  may  not  change  sign.  If  window  is  nonzero,  the  half  width  of  a  band 
aroimd  zero,  EPS  is  computed 

EPS  =  WINDOW/100  *  MAX  (  ABS(TMIN),  ABS(TMAX)  ) 

If  the  local  variable  falls  within  the  band,  the  new  minimum  or  maximum 
for  the  current  iteration  is  changed  to  lie  on  the  other  side  of  zero  from 
the  local  variable.  The  bandwidth  EPS  is  a  percentage  of  the  larger  of 
TMAX  or  TMIN  where  WINDOW  specifies  the  percentage.  (Real,  Input) 

Relation  of  global  design  variables  (Input) 

Relation  containing  the  relationship  between  local  variables  and  global 
variables  in  the  design  problem  (Input) 

Matrix  entity  containing  the  minimum  thickness  constraint  sensitivities 
(Input) 

Matrix  entity  containing  the  maximum  thickness  constraint  sensitivities 
(Input) 

The  design  variable  linking  matrix  (Character,Input) 

Relation  of  fixed  thickness  of  layer  (Input) 

Relation  of  constraint  values  (Output) 

Application  Calling  Sequence: 

None 

Method: 

This  module  first  computes  the  element  thickness  functions  which  are  required  by  any  user-defined 
functional  constraints.  Those  response  values  are  stored  into  a  relational  entity  to  be  used  by  the 
function  evaluation  utihties.  Then  the  module  determines  if  any  minimum  and  maximum  gauge 
constraints  exist  in  the  problem.  These  constraints  are  generated  by  ASTROS  if,  and  only  if,  shape 
function  design  variable  linking  is  used.  If  any  constraints  exist,  the  vector  of  design  vmahle  values 
from  and  all  the  LOCLVAR  data  are  brought  into  core.  The  next  step  is  to  determine  if  any  user 


NITER 

NDV 

MOVLIM 

WINDOW 


GLBDES 

LOCLVAR 

[PMINT] 

[PMAXT] 

[PTRANS] 

TFIXED 

CONST 


265 


specified  move  limit  on  the  local  variables  is  to  be  applied  to  the  minimum  thickness  constraints  (note 
that  the  maximum  thickness  constraints  are  always  computed  relative  to  their  gauge  hmits  rather  than 
to  a  move  limit). 

If  move  limits  are  applied  (as  they  almost  always  are),  the  dconthk  or  dconth2  data  are  also  brought 
into  core  to  identify  which  elements  minimum  gauge  constraints  are  always  to  be  retained  by  the 
constraint  deletion  algorithm  in  the  actcon  module.  The  minimum  gauge  constraints  are  then 
computed  by  performing  the  matrix  multiplication: 

{g}  =  1.0  -  [PMINT]’^{v}  =  1.0  -  -r^ 

^min 

The  LOCLVAR  data  is  then  used  to  determine  to  which  element  each  "g"  applies.  If  the  constraint  value 
is  less  critical  (more  negative)  than  the  move  limit  value  of 

g  =  1.0  -  MOVLIM 
^xnovo 

it  is  stored  on  the  CONST  relation  as  a  computed  constraint  only  if  it  appears  on  a  dconthk  or 
DCONTH2  entry  (in  which  case  it  will  end  up  as  an  active  constraint  from  ACTCON),  otherwise,  the 
constraint  is  ignored  for  this  design  iteration.  If  the  constraint  value  is  more  critical  than  the  move  limit 
value,  it  is  only  stored  on  CONST  if  it  is  on  a  DCONTHK  or  DCONTH2  entry  or  if  the  constraint  violates  a 
cutoff  value  set  to 

cr  =  0.10 

^retain  ^ 

Any  miniTmim  thickness  constraints  that  are  stored  on  CONST  that  do  not  appear  on  DCONTHK  or 
DCONTH2  entries  will  be  subject  to  the  normal  constraint  deletion  criteria.  The  maximum  gauge 
constraints  are  then  computed  by  performing  the  matrix  multiplication: 

{g}  =  [PMAXT]’^{v>  +  -  1.0 

The  LOCLVAR  data  is  then  used  to  determine  to  which  element  each  ’’g"  applies.  No  move  limits  are 
applied  to  these  constraints  and  they  are  stored  directly  to  the  CONST  relation  to  imdergo  the  normal 
constraint  deletion  in  ACTCON. 

Design  Requirements: 

1.  This  module  should  be  the  first  module  called  in  the  optimization  phase  of  the  MAPOL  sequence. 

2.  The  move  limit  that  is  passed  into  this  routine  must  match  the  value  used  to  evaluate  the  constraints 
in  the  makdfv  module.  If  not,  the  constraint  sensitivities  will  be  in  error  with  no  warning  given. 

Error  Conditions: 

1.  A  local  variable  has  become  negative  due  to  insufficient  DCONTHK  or  DCONTH2  entries  or  illegal  gauge 
constraints. 
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Engineering  Application  Module:  TRIMCHEK 
Entry  Point:  TRMCHK 


Purpose: 

1b  perform  preface  aerod3mamic  processing  on  the  requested  saero  discipline  requests  and  their 
referenced  TRIM  Bulk  Data  entries. 


MAFOL  Calling  Sequence: 

r-aT.T.  TRIMCHEK  (  MINDEX,  LOOP,  GOAERO,  CASE,  TRIMDATA  )  ; 


MIMDEX 


LOOP 


GOAERO 

CASE 


Mach  number  index  for  the  current  pass.  Controls  which  Mach  Num¬ 
ber/symmetry  conditions  will  be  processed  in  this  pass  of  steady.  One 
pass  for  each  unique  Mach  number  will  be  performed  with  mindex  incre¬ 
menting  by  one  until  trimchek  returns  loop=false  (Input) 

A  logical  flag  set  by  trimchek  to  indicate  whether  additional  mindex 
subscripts  are  needed  to  complete  the  processing  of  all  the  Mach  num¬ 
ber/symmetry  conditions  on  all  the  trim  entries.  One  pass  for  each 
unique  Mach  number  will  be  performed  with  mindex  incrementing  by 
one  imtil  trimchek  returns  loop=false  (Output) 

A  logical  flag  set  by  TRIMCHEK  to  indicate  whether  the  STEADY  module 
should  be  called  to  process  the  MiNDEX’th  Mach  Number  (Output) 

A  relation  describing  the  Solution  Control  Case  Definitions  (Input) 


TRIMDATA 


An  output  relation  that  contains  the  description  of  the  TRIM  entries  for 
each  boundary  condition  and  each  subcase.  The  TRIM  entries  for  each  sub¬ 
case  are  repeated,  even  if  the  data  are  the  same  so  as  to  uniquely  associ¬ 
ate  Mach  Numbers,  subcase  identification  numbers  and  mindex 
subscripts.  Input  accelerations  are  normalized  to  be  in  consistent  units 
(Output) 


Application  Calling  Sequence: 
None 


Method: 

The  TRIMCHEK  preface  module  performs  initial  aerodynamic  processing  for  planar  STEADY  aerodynam¬ 
ics.  It  is  driven  by  the  the  trim  data  present  in  the  bulk  data  packet  and  the  saero  disciplines  in  the 
f’ag'p.  relation.  The  CASE  relation  provides  the  symmetries  while  the  TRIM  relation  provides  the  Mach 
numbers.  Only  if  SAERO  disciplines  are  in  case  is  any  processing  done  and  both  trim  and  aeros  entries 
must  be  found. 


On  each  call,  the  PASSDF  submodule  is  called  to  determine  the  set  of  all  Mach  numbers  and,  for  each 
Mach  number,  whether  symmetric,  antisymmetric  or  both  boundary  conditions  are  to  be  applied.  Having 
determined  all  unique  Mach  numbers,  the  PASSDF  then  determines  the  MiNDEX’th  Mach  number  in 
numerical  order  (lowest  to  highest)  and  that  is  flagged  to  be  processed  using  the  GOAERO  flag.  If  the 
chosen  Mach  number  is  the  last  one,  the  LOOP  flag  is  set  to  false  to  tell  the  MAPOL  sequence  that  no 
more  ^alls  are  needed.  At  this  point,  the  GOAERO  flag  will  still  be  true  to  allow  processing  of  tiie  last 
Mach  number.  Only  if  no  saero  are  called  for  in  case  will  GOAERO  be  false  on  output. 
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Design  Requirements: 

1.  The  TRIMCHEK  module  interacts  with  the  executive  in  that  the  LOOP  variable  is  output  on  the  first 
call  and  the  module  expects  to  be  called  again  as  long  as  loop  is  true.  For  each  time  called,  the  mindex 
parameter  should  be  unique  although  it  need  not  be  monotonically  increasing. 

Error  Conditions: 

1.  Errors  in  the  TRIM  specifications  are  flagged. 
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Engineering  Application  Module:  UNSTEADY 
Entry  Point:  UNSTDY 


Purpose: 

Unsteady  aeroelastic  analysis  preface. 
MAPOL  Calling  Sequence: 


CALL  UNSTEADY 

(  GEOMUA,  AECOMPU,  [AJJTL] ,  [DlJK] ,  [D2JK] ,  [SKJ] 

AERUGEOM,  CAROUGEO  ) ; 

GEONUA 

A  relation  describing  the  aerodynamic  boxes  for  the  imSTEADY  aerody¬ 
namics  model.  The  location  of  the  box  centroid,  normal  and  pitch  moment 
avis  are  given.  It  is  used  in  splining  the  aerod3mamics  to  the  structare 
and  to  map  responses  back  to  the  aerodynamic  boxes  (Output) 

AECONPU 

A  relation  describing  aerodynamic  components  for  the  unSTEADY  aerody¬ 
namics  model.  It  is  used  in  splining  the  aerodynamics  to  the  structural 
model  (Output) 

[AJJTL] 

A  matrix  containing  the  transposed  unsteady  AXC  matrix  for  each  Mach 
ninnber,  reduced  frequency  and  symmetry  option  in  the  Bulk  Data 
MKAEROl  and  MKAER02  entries  (Output) 

[DIJK] 

Real  part  of  the  substantial  derivative  matrix  (Output) 

[D2JK] 

Imaginary  part  of  the  substantial  derivative  matrix  (Output) 

[SJK] 

Integration  matrix  to  take  pressures  to  force.  (Output) 

AERUGEOM 

Relation  containing  the  aerodynamic  planform  geometric  grid  points  for 
the  flutter  model  (Character,  Output) 

CAROUGEO 

Relation  containing  the  connectivity  data  for  the  aerodynamic  planform 
geometric  grid  points  for  the  flutter  model  (Character,  Output) 

Application  Calling  Sequence: 

None 

Method: 

The  unsteady  aerodynamics  preface  module  is  activated  under  the  following  conditions: 

1.  If  any  FLUTTER  cases  are  in  the  case  relation 

2.  K  any  BLAST  cases  are  in  the  CASE  relation 

3.  If  there  are  any  TRANSIENT  or  FREQUENCY  cases  that  invoke  the  GUST  option. 

After  checking  for  the  presence  of  the  proper  cases,  the  MKAEROl  and  MKAER02  data  are  read  from  the 
database  and  a  list  of  all  {symm,m,k}  sets  are  assembled.  The  first  record  of  the  UNMK  table  is  then 
written  containing  a  count  of  the  number  of  {m,k}  pairs  in  each  of  the  six  symmetiy  classes.  The  second 
record  will  be  loaded  within  the  APD  submodule  and  closed  on  return  to  UNSTEADY . 

Then  the  unsteady  aerodynamics  model  is  read  from  the  database  into  memory  for  the  apd  submodule. 
That  module  is  then  called  to  form  the  geometrical  description  of  the  unsteady  model.  The  acpt,  the 
GEOMUA  and  the  aecompu  entities  are  written  along  with  the  second  record  of  the  unmk. 
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Once  the  geometry  data  are  complete,  the  amg  submodiile  is  called  to  compute  the  AJJTL,  DlJK,  D2  JK 
and  SKJ  matrix.  These  computations  are  done  for  all  the  {s5nmm,m,k}  sets  in  the  bulk  data.  Each  AJJT 
matrix  is  appended  to  the  AJJTL  output  matrix.  The  DlJK,  DlJK  and  SJK  matrices  will  have  two 
separate  matrices  stored  in  a  similar  fashion  if  and  only  if  both  subsonic  and  supersonic  Mach  numbers 
appear  in  the  UNMK  sets.  Once  these  computations  are  complete,  UNSTEADY  returns  control  to  the 
MAPOL  sequence. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Engineering  Application  Module:  WOB  JGRAD 

Entry  Point:  WOBJGD 


Purpose: 

To  compute  weight  ftuiction  sensitivity  to  the  design  variables. 

MAFOL  Calling  Sequence: 

niLT.T.  WOBJGRAD  {  NITER,  NDV,  GLBDES,  DWGHl,  DDWGH2  ); 

Design  iteration  number  (Integer, Input) 

Number  of  design  variables  (Integer, Input) 

Relation  of  global  design  variables  (Character,Input) 

Unstructured  entity  of  invariant  linear  portion  of  the  weight  function  sen¬ 
sitivity  (Character,Input) 

Unstructured  entity  of  nonlinear  portion  of  the  weight  function  sensitiv¬ 
ity  (Character,Input) 


NITER 

NDV 

GLBDES 

DWGHl 

DDWGH2 


Application  Calling  Sequence: 

None 

Method: 

This  module  first  reads  all  DVID  from  relation  GLBDES.  Then  the  module  reads  entities  dwghI  md 
DDWGH2  into  memory.  Because  DWGHl  and  DDWGH2  have  the  design  variable  dvid  mdex  as  their  first 
record,  the  weight  function  sensitivities  may  be  generated  by  searching  for  this  dvid  m  dwghi  and 
DDWGH2  and  obtaining  the  corresponding  sensitivity  terms. 


Design  Requirements: 


None 


Error  Conditions: 
None 
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Engineering  Application  Module :  Y SMERGE 

Entry  Point:  YSMERG 


Purpose: 

To  provide  a  special  purpose  merge  utility  for  merging  YSdike  vectors  (vectors  of  enforced  displacements) 
into  matrices  for  data  recovery. 


MAPOL  Calling  Sequence: 

CALL  YSMERGE  (  [UN],  [YS(BC)],  [UF] ,  [PNSP(BC)],  DYNFLG  ); 


[UN] 

[YS{BC)] 

[UF] 

[PNSF(BC)] 

DYNFLG 


Matrix  containing  the  nodal  response  quantities  for  the  independent  de¬ 
grees  of  freedom  (Output) 

Optional  matrix  containing  the  vector  of  enforced  displacements  on  the 
single-point  constraint  degrees  of  freedom.  If  the  YS  argument  is  omitted, 
null  vectors  are  merged  (Input),  where  BC  represents  the  MAPOL  bound¬ 
ary  condition  loop  index  number 

The  matrix  of  free  nodal  response  quantities  to  be  merged  with  the  YS 
vector 

The  partitioning  vector  splitting  the  independent  degrees  of  freedom  into 
the  free  and  the  single  point  constraint  degrees  of  freedom  (Input),  where 
BC  represents  the  MAPOL  boundary  condition  loop  index  number 

D3Tiamic  matrix  form  flag:  if  DYNFLG  is  nonzero,  the  matrix  UF  is  as¬ 
sumed  to  have  the  form  of  a  dynamic  response  matrix:  three  columns  per 
subcase;  (1)  displacement,  (2)  velocity  and  (3)  acceleration  (Integer,  Input) 


Application  Calling  Sequence: 

None 

Method: 

The  YSMERGE  engineering  utility  module  is  a  general  utility  to  merge  a  column  vector,  YS,  (or  a  null 
column)  that  represents  a  partition  of  the  desired  output  matrix  with  the  other  partition,  UF,  based  on 
an  input  partitioning  vector.  The  column  dimension  of  UF  is  used  to  determine  the  number  of  times  YS 
is  to  be  duplicated  in  the  merge  operation.  The  result  is  loaded  into  the  UN  matrix.  As  a  special  option, 
the  DYNFLG  input  is  used  to  direct  the  module  to  assume  that  the  UF  and  UN  matrices  have,  or  are  to 
have,  the  form  of  a  dynamic  response  "displacement"  matrix.  These  matrices  have  three  columns  for 
each  time/frequency  step: 

(1)  Displacement 

(2)  Velocity 

(3)  Acceleration 

When  DYNFLG  is  nonzero,  the  YS  matrix  is  merged  with  the  first  column  (displacements)  of  each  triplet 
with  null  partitions  used  for  the  corresponding  velocities  and  accelerations. 
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1.  The  YS  matrix  entity,  if  it  is  included  in  the  calling  sequence, 
vector.  If  the  matrix  is  null,  the  routine  acts  as  though  it  were 


must  be  null  (no  columns)  or  be  a  column 
not  included  in  the  calling  sequence. 


Error  Conditions: 
None 
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6.  APPLICATION  UTILITY  MODULES 


Large  software  systems  such  as  ASTROS  require  that  similar  operations  be  performed  in  many 
code  segments.  To  reduce  the  maintenance  effort  and  to  ease  the  programming  task,  a  set  of  commonly 
used  application  utilities  were  identified  and  used  whenever  the  application  required  those  tasks  to  be 
performed.  This  section  is  devoted  to  the  documentation  of  the  set  of  application  utilities  in  ASTROS  .  The 
suite  of  utilities  in  ASTROS  includes  small  (performed  entirely  in  memoiy)  matrix  operations  like  linear 
equation  solvers,  matrix  multiplication  and  others.  Another  suite  of  utiUties  have  been  written  to  sort 
tables  or  columns  of  data  on  real,  integer  and  character  values  in  the  table.  Other  utilities  search  hsts  of 
data  stored  in  memory  for  particular  key  values,  initialize  arrays,  operate  on  matrix  entities  and  perform 
other  disparate  tasks  of  a  general  nature.  The  ASTROS  user  who  intends  to  write  appUcation  programs 
to  be  used  within  the  ASTROS  environment  is  strongly  urged  to  study  the  suite  of  utilities  documented  in 
this  section.  ASTROS  software  designed  to  make  use  of  the  suite  of  application  utilities  can  be  much 
simpler  to  write,  debug  and  maintain  since  these  well-tested  utilities  can  be  substituted  for  code  that 
would  otherwise  require  programming  effort. 

The  following  subsections  document  the  interface  to  ihe  application  utilities  in  two  formats;  using 
the  executive  system  (MAPOL)  and  using  the  FORTRAN  calling  sequence.  In  most  cases,  there  is  no 
MAPOL  language  interface  since  these  utilities  are  useful  only  within  an  application  module.  In  other 
cases,  however,  the  utiUty  has  been  identified  as  a  feature  accessible  through  the  executive.  Finally,  a 
small  number  of  these  application  utilities  are  intended  for  access  only  by  the  executive  system.  This 
family  of  utilities  is  always  associated  with  obtaining  formatted  output  of  data  stored  on  the  database. 


Application  Utility  Module:  APPEND 
Entry  Point:  APPEND 


Purpose: 

This  routine  adds  all  the  coliomns  of  one  input  matrix  to  the  end  of  another. 

MAPOL  Calling  Sequence: 

CALL  APPEND  (  MATOOT,  MATIN  ) ; 

Application  Calling  Sequence: 

CALL  APPEND  (  MATODT,  MATIN,  IKOR  ) 

MATODT  The  name  of  the  output  matrix  to  which  the  columns  are  added 

(Character,  Output) 

matin  The  name  of  the  input  matrix  from  which  the  extra  columns  are  ex¬ 

tracted  (Character,  Input) 

ikor  Open  core  base  address  for  local  dynamic  memory  allocation 

(Integer,  Input) 

Method: 

Matrix  MATODT  is  first  initialized.  Error  checks  are  made  to  see  if  the  matrices  are  conformable  for  the 
append  operation.  The  columns  of  MATIN  are  then  appended  to  the  MATODT  matrix  with  special 
provisions  given  to  handle  null  columns  in  MATIN. 

Design  Requirements: 

None 

Error  Conditions: 

1.  MATODT  has  not  been  created  first  (append  does  an  MXINIT,  but  the  entity  must  already  exist  as  a 
matrix). 

2.  MATOXTP  and  MATIN  have  different  types  (precision/real  or  complex). 

3.  MATODT  and  MATIN  have  a  different  number  of  rows. 


Application  Utility  Module:  DAXB 
Entry  Point:  DAXB 


Purpose: 

This  routine  takes  the  double-precision  cross  product  of  vectors  in  a  three-dimensional  space. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 


CALL  DAXB  (  A/  B, 
A 
B 
C 

Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 

None 


First  vector  (3x1)  (Double,  Input) 
Second  vector  (3x1)  (Double,  Input) 
Cross  product  A  X  B  (Double,  Output) 
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Application  Utility  Module:  GMMATC 
Entry  Point:  GMMATC 


Purpose: 

Perform  the  in-core  complex  matrix  multiplications: 

[A]  [B]  =  [C] 

[A]  [B]''  =  [C] 

[A]^[B]  =  [C] 

[Al’^tB]’^  =  [C] 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  GMMATC  (  A,  IROWA,  ICOLA,  MTA,  B,  IROWB,  ICOLB,  NTB,  C  ) 

A  Matrix  of  IROWA  rows  and  ICOLA  columns  stored  in  row  order  m  a  linear 

array  (Character,Input) 

B  Matrix  of  IROWB  rows  and  icoLB  columns  stored  in  row  order  in  a  linear 

array  (Character, Input) 

MTA,I]TB  Transpose  flags  (Character,Input) 

=  0  if  no  transpose 
=  1  if  transpose 

C  Result  of  the  matrix  multiplication  (Character, Output) 

Method: 

The  GMMATC  routine  assumes  that  sufficient  storage  space  is  available  in  core  to  perform  the  multipli¬ 
cation.  The  matrices  are  checked  to  ensure  that  they  are  of  proper  dimensions  to  be  multiphed.  Complex 
single-precision  is  used  throughout  the  routine. 

Design  Requirements: 

None 

Error  Conditions: 

None 


278 


Application  Utility  Module:  GMMATD 
Entry  Point:  GMMATD 


Purpose: 

Perform  the  in-core  double-precision  matrix  multiplications: 

[A]  [B]  =  [C] 

[A]  [B]’’  =  [C] 

IA]'^[B]  =  [C] 

[A]*[B]’'  =  [C] 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

r-ar.T.  GMMATD  (  A,  IROWA,  ICOLA,  MTA,  B,  IROWB,  ICOIiB,  NTB,  C  ) 

A  Matrix  of  IROWA  rows  and  ICOLA  columns  stored  in  row  order  in  a  linear 

array  (Character, Input) 

B  Matrix  of  IROWB  rows  and  ICOLB  columns  stored  in  row  order  in  a  linear 

array  (Character, Input) 

MTA,  NTB  Transpose  flags  (Integer, Input) 

=  0  if  no  transpose 
=  1  if  transpose 

C  Result  of  the  matrix  multiplication  (Character, Output) 

Method: 

The  GBMMATD  routine  assumes  that  sufficient  storage  space  is  available  in  core  to  perform  the  multipU- 
cation.  The  matrices  are  checked  to  ensure  that  they  are  of  proper  dimensions  to  be  multiphed.  Double 
precision  is  used  throughout  the  routine. 

Design  Requirements: 

None 

Error  Conditions: 


None 


Application  Utility  Module:  GMMATS 
Entry  Point:  GMMATS 


Purpose: 

Perform  the  in-core  single-precision  matrix  multiplications: 

lA]  IB]  =  [C] 

[A]  [B]’^  =  [C] 
lAl’^IB]  =  [C] 

[Al’^IB]’'  *  [Cl 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  GMMATS  (  A,  IROWA,  ICOLA,  MTA,  B,  IROWB,  ICOLB,  NTB,  C  ) 

A  Matrix  of  IROWA  rows  and  ICOLA  columns  stored  in  row  order  in  a  linear 

array  (Character, Input) 

B  Matrix  of  IROWB  rows  and  ICOLB  columns  stored  in  row  order  in  a  linear 

array  (Character, Input) 

MTA,NTB  Transpose  flags  (Integer,Input) 

=  0  if  no  transpose 
=  1  if  transpose 

C  Result  of  the  matrix  multiplication  (Character,Output) 

Method: 

The  GMMATS  routine  assumes  that  sufficient  storage  space  is  available  in  core  to  perform  the  multipli¬ 
cation.  The  matrices  are  checked  to  ensure  that  they  are  of  proper  dimensions  to  be  multiphed.  Single 
precision  is  used  throughout  the  routine. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module:  INVERC 
Entry  Poirit:  INVERC 


Single  precision  complex  in-core  matrix  inversion  and  linear  equation  solver.  Finds  solution  to  the 
matrix  equation: 

[A]{X}  =  {B} 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  INVERC  (  NDIM,  A,  N,  B,  M,  DETEFM/  ISING,  WORK2  ) 

The  leading  dimension  of  A  as  declared  in  the  calling  routine.  A  {NDiM,  N) 
(Integer,  Input). 

A  Array  containing  the  partition  to  be  inverted.  On  output,  the  contents  of 

the  upper  left  N  x  N  partition  are  replaced  by  the  inverse.  (Complex,  Input) 

N  Size  of  the  upper  left  A  partition  to  be  inverted.  (Integer,  Input) 

B  Column  of  constants  (optional  input  of  minimum  size:  B  (OTIM,  1 )  ).  On 

output,  contains  the  solution  vector(s)  of  the  linear  equations 
(Complex,  Input) 

M  Nvunber  of  columns  of  B  (Integer,  Input) 

DETERM  Determinant  of  A  if  nonsingular  (Complex,  Output) 

ISING  Error  flag 

=  1  if  A  nonsingular 
=  2  if  A  singular 
(Integer,  Input  and  Output) 

WORK2  Additonal  working  storage  (N,  3 )  (Complex,  Input) 


ISING 


WORK2 


Method: 

Note  that  aU  or  the  upper  left  square  partition  of  the  input  array  A  may  be  inverted.  If  on  input,  the 
value  of  ISING  is  less  than  zero,  the  determinant  of  the  A  matrix  is  not  calculated.  The  value  of  dete^ 
on  return  will  be  zero.  The  matrix  inversion  routine  uses  the  Gauss- Jordian  method  with  complete 
row-column  interchange.  Sufficient  core  storage  must  be  set  aside  in  INDEX  to  complete  the  mversion. 

Error  Conditions: 

None 
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Application  Utility  Module:  INVERD 

Entry  Point:  INVERD 

Purpose: 

Double  precision  in-core  matrix  inversion  and  linear  equation  solver.  Finds  solution  to  the  matrix 
equation: 

[AHX}  =  {B> 

MAPOL  CaUing  Sequence: 

None 

Application  Calling  Sequence: 

CALL  INVERD  (  NDIM,  A,  N,  B/  M,  DETERM,  ISIN6,  WORK2  ) 

NDIM  The  leading  dimension  of  A  as  declared  in  the  calling  routine.  a(NDIM,n) 

(Integer,  Input). 

A  Array  containing  the  partition  to  be  inverted.  On  output,  the  contents  of 

the  upper  left  N  x  N  partition  are  replaced  by  the  inverse.  (Double,  Input) 

Size  of  the  upper  left  A  partition  to  be  inverted.  (Integer,  Input) 


N 

B 

M 

DETERM 

ISING 


WORK2 


Column  of  constants  (optional  input  of  minimum  size:  B  (ndxh,  1 )  ).  On 
output,  contains  the  solution  vector(s)  of  the  linear  equations 
(Double,  Input) 

Number  of  columns  of  B  (Integer,  Input) 

Determinant  of  A  if  nonsingular  (Double,  Output) 

Error  flag 

=  1  if  A  nonsingular 
=  2  if  A  singular 
(Integer,  Input  and  Output) 

Working  storage  (N,3)  (Double,  Input) 


Method: 

Note  that  aU  or  the  upper  left  square  partition  of  the  input  array  A  may  be  inverted.  If  on  input,  the 
value  of  ISING  is  less  than  zero,  the  determinant  of  the  A  matrix  is  not  c^culated.  The  value  of  DETERM 
on  return  will  be  zero.  The  matrix  inversion  routine  uses  the  Gauss-Jordian  method  with  complete 
row-colunm  interchange.  Sufficient  core  storage  must  be  set  aside  in  index  to  complete  the  inversion. 

Error  Conditions: 

None 
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Application  Utility  Module;  INTERS 
Entry  Point:  INTERS 


Purpose: 

Single  precision  in-core  matrix  inversion  and  linear  equation  solver.  Finds  solution  to  the  matrix 
equation: 

tA]{X}  =  {B} 


MAPOL  Calling  Sequence: 
None 


Application  Calling:  Sequence: 

N,  B,  M,  DETEBM,  ISING,  WORK2  ) 

CALL  INVERS  (  NDIM,  J 

NDIM 

The  leading  dimension  of  A  as  declared  in  the  calling  routine.  a{ndim,N) 
(Integer,  Input). 

A 

Array  containing  the  partition  to  be  inverted.  On  output,  the  contents  of 
the  upper  left  N  x  N  partition  are  replaced  by  the  inverse.  (Real,  Input) 

N 

B 

Size  of  the  upper  left  A  partition  to  be  inverted.  (Integer,  Input) 

Column  of  constants  (optional  input  of  minimum  size:  B  (OTIM,  1 )  ).  On 
output,  cnritains  the  Solution  vector(s)  of  the  linear  equations  (Real,  Input) 

M 

Niunber  of  columns  of  B  (Integer,  Input) 

DETERM 

Determinant  of  A  if  nonsingular  (Real,  Output) 

ISING 

Error  flag 

=  1  if  A  nonsingvdar 
=  2  if  A  singular 
(Integer,  Input  and  Output) 

WORK2 

Working  storage  (N,  3 )  (Real,  Input) 

Method: 

Note  that  all  or  the  upper  left  square  partition  of  the  input  array  A  may  be  inverted.  If  on  input,  the 
value  of  ISING  is  less  than  zero,  the  determinant  of  the  Amatrixis  not  calculated.  The  value  of  DET^ 
on  return  will  be  zero.  The  matrix  inversion  routine  uses  the  Gauss-Jordian  method  with  complete 
row-column  interchange.  Sufficient  core  storage  must  be  set  aside  in  index  to  complete  the  mversion. 

Error  Conditions: 

None 
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Application  Utility  Module:  MSGDMP 
Entry  Point:  MSGDMP 


Purpose: 

Retrieves  messages  queued  by  the  utmwrt  module  and  writes  them  to  the  system  output  file. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MSGDMP 

Method: 

The  MSGDMP  routine  reads  the  queued  messages  written  by  utmwrt  from  the  queue  file  and  writes  them 
onto  the  system  output  file.  The  queue  file  is  then  reset  to  accept  the  next  set  of  messages.  The  intention 
is  that  MSGDMP  will  be  called  after  each  module’s  execution  to  allow  easy  determination  of  the  last  module 
executed,  shotild  the  execution  terminate. 

Error  Conditions: 

None 
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Application  Utility  Module:  POLCOD 
Entry  Point:  POLCOD 


Purpose: 

This  routine  computes  double-precision  polynomial  fit  coefficients. 


MAPOL  Calling  Sequence: 


None 

Application  Calling  Sequence: 

CALL  POLCOD  (  X,  Y/  N,  S,  COF  ) 

X  The  vector  of  scalar  variables  of  length  N  (Input,  Double  Precision) 

Y  The  vector  of  terms  such  that 


N 

s 

COF 


lYd)]  =  [Y]  at  X(l) 

(Input,  Double  Precision) 

The  rank  of  vectors  X  and  Y  (Input,  Integer) 

The  scratch  array  of  length  N  to  store  the  master  polynomial  coefficients 
(Input,  Double  Precision) 

The  vector  of  coefficients  such  that 

[Y{Z)]  =  [COF(l)]  +  Z[COF(2)]  +  Z**2[COF{3)]  +  ... 
(Output,  Double  Precision) 


Method: 

This  routine  computes  polynomial  fit  coefficients  from  solution  of  Vandermonde  matrix  equations.  It  is 
taken  firom  "Numerical  Recipes,"  Section  3.5,  routine  POLCOE. 

Design  Requirements: 

1.  Use  POLEVD  to  evaluate  the  polynomial  values  based  on  the  computed  coefficients. 

2.  Use  POLSLD  to  evaluate  the  polynomial  derivative  values  based  on  the  computed  coefficients. 
Error  Conditions: 

None 
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Application  Utility  Module:  POLCOS 
Entry  Point:  POLCOS 


Purpose: 

This  routine  computes  single-precision  polynomial  fit  coefficients. 

MAFOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  POLCOS  (  X/  y,  N,  S,  COF  ) 

X  The  vector  of  scalar  variables  of  length  N  (Input,  Real) 

Y  The  vector  of  terms  such  that 

[Y(l)]  =  [Y]  at  X(l) 

[Y(2)]  =  [Y]  at  x(2) 

(Input,  Real) 

N  The  rank  of  vectors  X  and  Y  (Input,  Integer) 

s  The  scratch  array  of  length  N  to  store  the  master  polynomial  coefficients 

(Input,  Real) 

COF  The  vector  of  coefficients  such  that 

[Y(Z)]  =  [COF(l)]  +  Z[COF(2)]  +  Z**2ICOF(3)]  +  ... 

(Output,  Real) 

Method: 

This  routine  computes  poljmomial  fit  coefficients  firom  solution  of  Vandermonde  matrix  equations.  It  is 
taken  from  "Numerical  Recipes,"  Section  3.5,  routine  POLCOE. 

Design  Requirements: 

1.  Use  POLEVS  to  evaluate  the  pol3momial  values  based  on  the  computed  coefficients. 

2.  Use  POLSLS  to  evaluate  the  polynomial  derivative  values  based  on  the  computed  coefficients. 
Error  Conditions: 

None 
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Application  Utility  Module:  POLEVD 
Entry  Point:  POLEVD 


Purpose: 

This  routine  performs  double-precision  polynomial  evaluation  from  fit  coefficients. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  POLEVD  (  COF,  N,  X,  Y  ) 

QQP  The  vector  of  coefficients  such  that 

[Y(Z)]  =  [COF{l)]  +  ZCCOF(2)]  +  Z**2[COF(3)]  +  ... 
(Input,  Double  Precision) 

N  The  rank  of  vectors  x  and  Y  (Input,  Integer) 

X  The  scalar  value  at  which  polynomial  is  evaluated 

(Input,  Double  Precision) 

Y  The  function  value  at  X  (Output,  Double  Precision) 


Method: 

This  routine  performs  double-precision  polynomial  evaluation  from  fit  coefficients  from  solution  of 
Vandermonde  matrix  equations.  It  is  taken  from  "Nrunerical  Recipes,"  Section  3.5,  routine  POLCOE. 

Design  Requirements: 

1.  Use  POLCOD  to  evaluate  the  fit  coefficients. 

2.  Use  POLSLD  to  evaluate  the  polynomial  derivative  values  based  on  the  computed  coefficients. 
Error  Conditions: 

None 


287 


Application  Utility  Module;  POLEVS 
Entry  Point:  POLEVS 


Purpose: 

This  routine  performs  single-precision  polynomial  evaluation  from  fit  coefficients. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  POLEVS  (  COF,  N,  X,  Y  ) 

coF  The  vector  of  coefficients  such  that 

[Y{Z)]  =  [C0F{1)1  +  Z[COF(2)]  +  Z**2[COF(3)]  +  ... 
(Input,  Real) 

N  The  rank  of  vectors  X  and  Y  (Input,  Integer) 

X  The  scalar  value  at  which  polynomial  is  evaluated  (Input,  Real) 

Y  The  function  value  at  X  (Output,  Real) 

Method: 

This  routine  performs  single-precision  polynomial  evaluation  from  fit  coefficients  from  solution  of 
Vandermonde  matrix  equations.  It  is  taken  from  "Numerical  Recipes,"  Section  3.5,  routine  POLCOE. 

Design  Requirements: 

1.  Use  POLCOS  to  evaluate  the  fit  coefficients. 

2.  Use  POLSLS  to  evaluate  the  polynomial  derivative  values  based  on  the  computed  coefficients. 
Error  Conditions: 

None 
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Application  Utility  Module:  POLSLD 
Entry  Point:  POLSLD 


Purpose: 

This  routine  performs  double-precision  polynomial  derivative  evaluation  from  fit  coefficients. 

MAFOL  Calling  Sequence: 

None 


Application  Calling  Sequence: 

CALL  POLSLD  (  COF,  N,  X,  Y  ) 

The  vector  of  coefficients  such  that 

[Y(Z)]  =  [COF(l)]  +  Z[COF(2)]  +  Z**2[COF{3)]  +  ... 

(Input,  Double  Precision) 

N  The  rank  of  vectors  x  and  Y  (Input,  Integer) 

X  The  scalar  value  at  which  polynomial  is  evaluated 

(Input,  Double  Precision) 

Y  The  slope  of  fimction  at  x  (Output,  Double  Precision) 


Method: 


This  routine  performs  double-precision  polynomial  derivative  evaluation  from  fit  coefficients  from 
solution  of  Vandermonde  matrix  equations.  It  is  taken  from  "Numerical  Recipes,  Section  3.5,  routine 

POLCOE. 


Design  Requirements: 

1.  Use  POLCOD  to  evaluate  the  fit  coefficients. 

2.  Use  POLEVD  to  evaluate  the  polynomial  values  based  on  the  computed  coefficients. 


Error  Conditions: 
None 
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Application  Utility  Module:  POLSLS 
Entry  Point:  POLSLS 


Purpose: 

This  routine  performs  single-precision  polynomial  derivative  evaluation  from  fit  coefficients. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  POLSLS  (  COP,  N,  X,  Y  ) 

COP  The  vector  of  coefficients  such  that 

[Y(Z)]  =  [COPd)]  +  Z[COP(2)]  +  Z**2[COP(3)]  +  ... 
(Input,  Real) 

N  The  rank  of  vectors  x  and  Y  (Input,  Integer) 

X  The  scalar  value  at  which  pol5momial  is  evaluated  (Input,  Real) 

Y  The  slope  of  function  at  X  (Output,  Real) 


Method: 

This  routine  performs  single-precision  polynomial  derivative  evaluation  from  fit  coefficients  from 
solution  of  Vandermonde  matrix  equations.  It  is  taken  from  "Numerical  Recipes,"  Section  3.5,  routine 

POLCOE. 

Design  Requirements: 

1.  Use  POLCOD  to  evaluate  the  fit  coefficients. 

2.  Use  POLEVD  to  evaluate  the  polynomial  values  based  on  the  computed  coefficients. 

Error  Conditions: 

None 
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Application  Utility  Module:  PS 
Entry  Point:  PS 


Purpose: 

Character  function  returns  the  character  string  as  the  matrix  precision  needed  for  mxinit,  memory 
management  and  others  based  on  the  machine  precision 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

PS  (  TYPFLG  ) 

typflg  Character  string,  either  "R"  or  "c"  for  real  or  complex  (Character,  Input) 


Method: 


PS  returns  character  string  RDP  on  double-precision  machines  or  RSP  on  single-precision  maclmes  for 
input  TYPFLG  of  R,  in  other  words  PS  { 'R' )  returns  either  RSP  or  RDP.  The  complex  equivalent  CDP  or 
CSP  is  returned  if  TYPFLG  is  C, 


Design  Requirements: 

None 

Error  Conditions: 

1.  If  TYPFLG  in  PS  is  neither  "R”  nor  ”C",  PS  will  retxim  blank. 
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Application  Utility  Module:  RDDMAT 
Entry  Point:  RDDMAT 


Purpose: 

Reads  a  double-precision  matrix  entity  into  memory. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

f^aT.T.  RDDMAT  {  MATNAM,  NROW,  MCOL,  BIiKN,  GRPN,  PNTR,  DKOR  ) 

HATNAM  Input  Matrix  database  entity  (Character,  Input) 

NROW  The  number  of  rows  in  the  matrix  (Integer,  Output) 

Ncol  The  number  of  columns  in  the  matrix  (Integer,  Output) 

blkn  The  name  of  the  open  core  block  to  which  the  data  are  written 

(Character,  Input) 

GRPN  The  name  of  the  open  core  group  to  which  the  data  are  written 

(Character,  Input) 

PNtr  The  pointer  relative  to  dkor  where  the  matrix  data  begin. 

(Integer,  Output) 

dkor  The  double-precision  open  core  base  address.  (Double,  Input) 

Method: 

The  matrix  is  opened,  its  size  determined  and  a  memory  block  with  group  name  grpn  and  block  name 
BLKN  is  allocated  to  hold  the  matrix  data.  The  matrix  is  then  read  into  core  with  special  provisions  being 
taken  to  handle  the  case  of  null  columns.  The  matrix  is  then  closed.  The  calling  routine  is  responsible 
for  freeing  the  memory  block. 

Design  Requirements: 

1.  The  matrix  must  be  closed  on  calling  this  routine. 

Error  Conditions: 

1.  Insxrfficient  open  core  memory  wiU  cause  ASTROS  termination. 
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Application  Utility  Module:  RDSMAT 
Entry  Point:  RDSMAT 


Purpose: 

Reads  a  single-precision  matrix  entity  into  memory. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  RDSMAT  (  MATNAM,  NROW,  NCOL,  BLKN,  GRPN,  PNTR,  RKOR  ) 


MATNAM 

NROW 

NCOL 

BLKN 

GRBN 

PNTR 

RKOR 


Input  Matrix  database  entity  (Character,  Input) 

The  number  of  rows  in  the  matrix  (Integer,  Output) 

The  number  of  columns  in  the  matrix  (Integer,  Output) 

The  name  of  the  open  core  block  to  which  the  data  are  written 
(Character,  Input) 

The  name  of  the  open  core  group  to  which  the  data  are  written 
(Character,  Input) 

The  pointer  realtive  to  DKOR  where  the  matrix  data  begin. 
(Integer,  Output) 

The  single-precision  open  core  base  address.  (Real,  Input) 


Method: 

The  matrix  is  opened,  its  size  determined  and  a  memory  block  with  group  name  GRPN  and  block  name 
BLKN  is  allocated  to  hold  the  matrix  data.  The  matrix  is  then  read  into  core  with  speaal  provisions  bemg 
taken  to  handle  the  case  of  null  columns.  The  matrix  is  then  closed.  The  calling  routme  is  responsible 
for  freeing  the  memory  block. 

Design  Requirements: 

1.  The  matrix  must  be  closed  on  calling  this  routine. 


Error  Conditions: 

1.  Insufficient  open  core  memory  will  cause  ASTROS  termination. 
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Application  Utility  Module:  SAXB 

Entry  Point:  SAXB 

Purpose: 

This  routine  takes  the  single-precision  cross  product  of  vectors  in  a  three-dimensional  space. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  SAXB  (  A,  B,  C  ) 

A  First  vector  (3x1)  (Real,  Input) 

B  Second  vector  (3x1)  (Real,  Input) 

c  Cross  product  A  X  B  (Real,  Output) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module:  SHAPEGEN 
Entry  Point:  SHAPGN 


Purpose: 

Generates  a  set  of  shape  Bulk  Data  entries  for  use 
specified  elements. 


in  ASTROS  based  on  the  element  centroids  of  the 


Manol  Calling  Sequence; 

CALL  SHAPEGEN  (  SHPGEN  ) 


SHPGEN 


Relation  defining  the  design  variable  shape  function  identification  num¬ 
ber,  the  list  of  associated  elements  and  the  shape  to  be  generated  as  the 
innut  from  Bulk  Data  filo  (Character,  Input) 


Application  Calling  Sequence: 
None 


Method 


moa: 

Tbi9  module  first  read  the  input  Bulk  Data  relation  SHPGEN.  Then  for  each  relation  shpg^  ent^,  the 
coefficients  are  computed  and  the  shape  entry  is  wntten  mto  the  punch  file. 


Design  Requirements: 
None 

Error  Conditions: 


None 
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Application  Utility  Module:  USETPRT 
Entry  Point:  USETPR 


Purpose: 

lb  print  the  structural  set  definition  table  for  each  boundary  condition  contained  in  the  USET  entity 

MAPOL  Calling  Sequence: 

CALL  USETPRT  (  USET{BC),  BGPDT{BC)  ) 

USET  The  USET  entity  for  the  current  boundary  condition  (Character,  Input) 

BGPDT  The  BGPDT  entity  for  the  current  boundary  condition  (Character,  Input) 

Application  Calling  Sequence: 

None 

Method: 

The  USET  entity  is  opened  to  determine  which  boundary  condition  is  to  be  processed.  The  CASE  relation 
is  opened  and  the  appropriate  TITLE,  SUBTITLE  and  label  information  are  obtained. 

The  INTID,  EXTID  and  FLAG  attributes  of  the  BGPDT  are  brought  into  core  and  sorted  on  internal  id. 
The  USET  record  for  the  current  boxindary  condition  is  also  brought  into  an  open  core  memory  block. 
Each  tuple  of  the  BGPDT  is  processed;  each  point  in  the  structural  set  has  its  corresponding  USET  bit 
mask  decoded  to  determine  to  which  structural  sets  the  degree  of  freedom  belongs.  A  running  count  in 
each  dependent  and  independent  structural  set  is  maintained  and  echoed. 

Error  Conditions: 


None 


Application  Utility  Module;  UTCOPY 
Entry  Point:  UTCOPY 


Purpose: 

Tb  copy  a  specified  number  of  contiguous  single-precision  words  from  one  location  to  another. 

Application  Calling  Sequence: 

CALL  UTCOPY  (  DEST/  SOURCE,  NWORD  ) 

PEST  Source  array  to  be  copied  (Character, Input) 

SOURCE  Destination  array  (Character, Input) 

jjwoRD  Number  of  single-precision  words  to  be  copied  (Integer, Input) 


Method: 

The  source  and  destination  arrays  are  operated  on  as  integer  arrays  inside  the  otcopy  routme.  If 
double-precision  data  are  to  be  copied,  the  NWORD  argument  must  be  adjusted  accordmgly. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module;  UTCSRT 
Entry  Point:  UTCSRT 


Purpose: 

To  sort  a  table  of  numbers  on  a  four  or  eight  character  hollerith  column  of  the  table 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  UTCSRT  (  ISORT,  ITBROW,  BOTLIM,  TOPLIM,  KEYPOS,  TOTLEN,  KEYLEN  ) 


ISORT 

Array  to  be  sorted  (Any,  Input) 

ITBROW 

An  array  of  length  TOTLEN  single-precision  words  used  to  store  a  table 
row  (Any,  Input) 

BOTLIM 

The  location  in  the  isORT  array  of  the  first  word  of  the  first  entry  to  be 
sorted  (Integer,  Input) 

TOPLIM 

The  location  in  the  isort  array  of  the  last  word  of  the  last  entry  to  be 
sorted  (Integer,  Input) 

KEYPOS 

The  column  in  the  table  of  the  first  word  of  the  1  or  two  word  character 
field  on  which  the  sort  occurs.  It  must  be  a  value  between  1  and  TOTLEN 
(Integer,  Input) 

TOTLEN 

The  length  in  single-precision  words  of  one  table  row  (Integer,  Input) 

KEYLEN 

The  number  of  characters  in  the  hollerith  string.  Must  be  either  four  or 
eight.  If  it  is  not  four,  it  is  ass\uned  to  be  eight  without  warning 
(Integer,  Input) 

Method: 

The  UTCSRT  routine  uses  a  QUICKSORT  algorithm  out  lined  in  "The  Art  Of  Computer  Programming, 
Volume  3  /  Sorting  And  Searching"  by  D.E.  Knuth,  Page  116.  Several  improvements  have  been  made 
over  the  pure  quicksort  algorithm.  The  first  is  a  random  selection  of  the  key  value  around  which  the 
array  is  sorted.  This  feature  allows  this  routine  to  handle  partially  sorted  information  more  rapidly  than 
the  pure  quicksort  algorithm.  The  second  improvement  in  this  routine  is  that  a  cutoff  array  length  is 
used  to  direct  further  array  sorting  to  an  insert  sort  algorithm  (Ibid.  Page  81).  This  method  has  proven 
to  be  more  rapid  allowing  small  arrays  to  be  sorted  by  the  quicksort  algorithm.  Presently  this  cutoff 

length  is  set  at  15  entries.  Studies  should  be  conducted  on  each  type  of  machine  in  order  to  set  this  cutoff 
length  to  maximize  the  speed  of  this  routine.  This  sorting  algorithm  requires  a  integer  stack  in  which 
to  place  link  information  during  the  sort.  The  maximum  required  size  for  this  stack  array  in  twice  the 
natural  log  of  the  number  of  rows  in  the  table.  At  present,  the  UTCSRT  routine  has  hard  coded  an  array 
of  size  (2,40)  which  provides  for  1  trillion  entries  to  be  sorted. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module:  utexit 

Entry  Point:  UTEXIT 

Purpose: 

lb  terminate  the  execution  of  the  system  when  an  error  occurs. 

MAPOL  Calling  Sequence: 

CALL  EXIT; 

Application  Calling  Sequence: 

CALL  UTEXIT 


Method: 

The  UTEXIT  routine  is  caUed  to  cleanly  terminate  the  execution  of  the  ^TROS  system.  I*  ^^he 
DBTEEM  database  termination  program  to  provide  for  normal  closing  of  the  ^  ^ 

the  queued  messages  from  the  UTMWRT  utility.  When  these  tasks  have  been  completed,  the  progr 

execution  is  terminated. 

Design  Requirements: 

None 


Error  Conditions: 
None 
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Method: 

The  matrix  names  are  tested  against  the  hst  of  supported  matrices.  If  the  matrix  entity  matches  one  of 
the  supported  entities  it  is  printed  in  a  format  based  on  the  structural  degrees  of  freedom  (similar  to 
displacement  and  eigenvector  output  from  OFP).  If  the  matrix  name  is  not  recognized,  a  call  to  OTMPRT 
is  made  instead  to  print  the  matrix  out  in  standard  banded  format.  The  print  format  results  in  one  line 
of  output  for  each  grid  or  scalar  point  in  the  structural  model  for  each  column  of  the  matrix.  Each  line 
of  output  contains  one  value  for  each  of  the  (up  to)  six  degrees  of  freedom  associated  with  it. 


Requirements: 


1.  Only  certain  g-size  matrices  are  printable  in  the  format  of  this  routine.  The  currently  available 
matrices  are:  DKOG,  DMUG,  DPVJ,  DUG,  DPGV,  DUGV,  DPTHVI,  DPGRVI,  PG,and  DFDU.  other 
matrices  used  in  this  routine  will  result  in  a  call  to  the  utmprt  utihty. 


Error  Conditions: 
None 
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Application  Utility  Module:  UTMCOR 
Entry  Point:  UTMCOR 


Purpose: 

A  special  purpose  utility  to  write  an  error  message  that  insufficient  open  core  is  available  in  a  functional 
module. 


MAPOL  Calling  Sequence: 


None 

Application  Calling  Sequence: 
CALL  UTMCOR  (  MORCOR, 
MORCOR 

TYPE 


SUBMAM 


TYPE,  SUBNAM  ) 

Integer  containing  the  number  of  entries  of  type  type  requested  in  the 
module  terminating  execution  (Integer,  Input) 

String  identifying  the  type  of  data  entries  requested: 

=  RSP  for  real,  single-precision 
=  RDP  for  real,  double-precision 
=  CSP  for  complex,  single-precision 
=  CUP  for  complex,  double-precision 
=  CHAR  for  character  data  (Character,  Input) 

A  character  string  containing  the  name  of  the  module  or  subroutine  that 
is  termmating  execution 


Method: 

The  UTMCOR  utility  does  an  MMSTAT  call  to  determine  the  maximum  available  open  core.  The  TYPE  FLAG 
is  used  to  determine  how  many  single-precision  words  are  needed  to  satisfy  the  request  for  morcor 
entries  The  difference  between  the  required  space  and  the  maximum  contiguous  memory  is  used  m  a 
call  to  UTMWRT  specifying  the  number  of  additional  words  needed.  The  SUBNAM  is  also  sent  to  OTMWRT 
to  identify  the  failure  more  precisely.  Note  that  type=char  is  treated  by  UTMCOR  as  equivalent  to  RSP; 
the  programmer  must  factor  the  number  of  words  per  entry  and  input  morcor  appropriately  factored. 
After  the  message  write  utihty,  utmcor  calls  the  utexit  utiUty  to  terminate  the  execution. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module:  UTMINT 

Entry  Point:  UTMINT 

Purpose: 

A  special  purpose  utility  to  initialize  a  matrix  entity  of  the  machine  precision  to  a  diagonal  or  null  matrix. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  UTMINT  (  MATNAM,  VAL,  NROWS,  NCOLS  ) 

MATNAM  Character  name  of  matrix  entity  to  be  mitialized  (Character,  Input) 

VAL  Single  precision  real  value  to  initialize  diagonal  terms  (  Real,  Input ) 

NROWS  The  number  of  rows  to  be  initialized  (Integer,  Input) 

NCOLS  The  number  of  columns  to  be  initialized  (Integer,  Input) 

Method: 

The  UTMINT  uses  the  double  function  to  determine  if  the  matrix  to  be  initialized  is  single  or 
double-precision.  The  requested  entity  is  then  opened  and  flushed.  No  check  is  made  to  ensure  that  the 
requested  matrix  exists.  Based  on  the  value  of  VAL,  one  of  several  paths  through  the  utility  is  taken.  If 
VAL  is  not  zero,  a  diagonal  matrix  with  diagonal  terms  given  the  value  of  VAL  is  created.  If  the  non-zero 
value  is  1.0  and  NROWS  equals  ncols,  the  resulting  identity  matrix  is  specifically  declared  as  such  m 
the  MXINIT  call.  If  the  matrix  is  rectangular,  extra  columns,  if  any,  are  null.  If  VAL  is  zero,  a  null  matrix 
of  the  requested  row  and  column  dimensions  is  created.  Note  that  all  the  matrices  created  by  this  utility 
are  of  the  machine  precision  as  determined  by  the  double  function. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module:  UTMPRG,  UTRPRG,  UTUPRG 

Entry  Point:  UTXPRG 


Purpose: 

To  piirge  the  contents  of  database  entities  but  leave  the  entity  in  existence. 

MAPOL  Callinsf  Sequence: 

CALL  UTMPRG  {  MATl,  MAT2,  MATlO  ); 

CALL  UTRPRG  (  RELl/  R£L2#  •••#  RELIO  ); 

CALL  UTOTRG  (  ONSl#  UNS2,  *••/  UNSIO  ); 


Application  Calling  Sequence: 

CALL  DBFLSH  (  ENTITY 

MATi 

RELi 

UNSi 

ENTITY 


) 

Matrix  entity  name  (Character,  Input) 
Relation  entity  name  (Character,  Input) 
Unstructured  entity  name  (Character,  Input) 
Any  entity  name  (Character,  Input) 


Method: 

The  UTMPRG  UTRPRG  and  UTUPRG  MAPOL  calls  are  defined  to  allow  up  to  10  entities  of  a  single  type 
to  be  purged’from  the  MAPOL  sequence.  The  application  interface  is  the  DBFLSH  routme  which  can  take 
a  single  argument  of  an  entity  name  of  any  t3rpe. 

Design  Requirements: 

None 


Error  Conditions: 


None 


Application  Utility  Module:  UTMPRT 

Entry  Point:  UTMPRT 

Purpose: 

Tb  print  the  contents  of  database  matrix  entities  to  the  system  output  file. 

MAPOL  Calling  Sequence: 

CALL  UTMPRT  (  METHOD,  MATl,  MAT2,  MATIO  ); 

Application  Calling  Sequence: 

CALL  UTMPRT  (  MATl,  METHOD,  IKOR,  DKOR  ) 

METHOD  Print  method  selection  (optional  for  the  MAPOL  call) 

(Integer,  Input) 

MATi  Matrix  entity  name  (Character,  Input) 

IKOR,  DKOR  Base  addresses  of  dynamic  memory  (Real  and  Double,  Input) 

Method: 

If  METHOD  is  zero  (or  absent  from  the  MAPOL  call),  the  matrix  entity  mat!  is  printed  in  a  banded  format: 
that  is,  all  the  terms  firom  the  first  non-zero  term  to  the  last  non-zero  term  (inclusive)  are  unpacked  and 
printed.  Null  colrunns  and  groups  of  null  columns  are  identified  as  such.  Note  that  the  MAPOL  sequence 
call  allows  for  up  to  10  matrix  entities  to  be  printed.  A  nonzero  METHOD  prints  the  column  by  string  with 
no  intervening  zeros. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module;  utmwrt 
Entry  Point:  UTMWRT 


Purpose: 

ssage  writer.  It  queues  error  messages  to  a  temporary  file  for 
The  MSGDMP  utility  is  used  to  actually  print  the  queued  messages. 

MAPOL  Calling  Sequence: 

None 


This  routine  acts  as  the  system  me 
subsequent  printing  to  the  output  file 


Application  Calling  Sequence: 

CAIiIi  UTMWRT  (  LEVEL/  NUMBER#  ARGMTS  ) 

jjevel  Severity  level  of  the  message  (Integer, Input) 

<  0  No  message  header  is  written 
=  0  General  Information 
=  1  System  Fatal  Message 
=  2  User  Information  Message 
=  3  User  Warning  Message 
=  4  User  Fatal  Message 


NUMBER 

ARGMTS 


Ttext  string  containing  the  message  number  in  the  form:  NN.MM.  LL 
(Character, Input) 

Ihxt  array  containing  arguments  for  the  message  text  (Character,Input) 


Method: 

The  UTMWRT  routine  cracks  the  message  number  NUMBER  into  its  toee 

module  number,  mm,  the  message  number,  and  LL,  the  message  length(m  records).  If  LL  is  omitted  (le 
number=nn.mm),  it  defaults  to  one  record  in  length. 

The  correct  message  text  is  then  recovered  from  themessage  file  by  quer^gtheMSGL^fortheinod^e 

NN  to  obtain  the  starting  record  and  adding  the  message  number  (MM)  and  message  length  (LL)  to  obtam 
the  record  numbers  where  the  message  text  is  stored.  The  message  text  is  of  the  form. 

' - text - $ - text — $ — . ' 

If  any  S  (dollar  signs)  orist  in  tho  message  tent,  they  sme  replaeed  by  the  MOMTS  supplied  in  the 
statement.  Note  that  the  final  message  tent  including  the  JuraHTS  must  be  less  than  128  characters  m 

length. 

Design  Requirements: 

1  The  pointers  to  the  system  database  entity  that  contains  the  error  message  te^s  for  each  "module- 
must  be  stored  in  memory.  Currently,  the  array  for  pointer  storage  is  200  words  long  which  means 
that  no  more  than  100  distinct  "modules"  can  be  defined.  Note  that  this  does  not  imply  any  limit  on 
the  number  of  error  messages  within  a  particular  module’s  group  of  messages. 
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Error  Conditions: 


1.  UTMWRT  error:  the  number  of  modules  exceeds  the  limit  of  $.  This  message  results  in  program 
termination  and  can  only  be  fixed  by  increasing  the  size  of  the  message  pointer  storage  array. 

2.  Error  in  utmwrt  when  processing  message  number  $.  This  message  is  a  system  level  error  which 
usually  implies  that  a  non-valid  message  number  nn.mm.ll  was  passed  to  the  modiile. 

3.  If  the  resultant  message  is  longer  than  128  characters,  the  unexpanded  text  is  printed  (with  $’s) 
and  the  arguments  are  echoed. 
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Application  utility  Module;  UTPAGE,  UTPAG2 
Entry  Points:  UTPAGE ,  UTPAG2 


Purpose: 

H.  handle  paging  of  the  syetem  output  file  during  execution  of  the  system.  UTPAGt  performs  a  page  eject 
based  on  an  anticipated  number  of  lines  to  print. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  UTPAGE 
CALL  UTPAG2  (  N  ) 

II  Number  of  lines  that  will  be  printed  (Integer,  Input) 


Method: 

The  UTPAGE  routine  keeps  track  of  the  total  line  count  and  the  line  co^t  for  the  c^ent  page.  The  to^ 
number  of  output  lines  allowed  is  maintained  for  use  by  this  module.  These  quantities  ^e  stored  m  t 
OUTPTl  common  block.  The  OUTPT2  common  block  is  also  used  to  store  the  header  and  titlmg 
the  current  execution.  When  output  to  the  system  output  ffle  is  being  performed,  the  Ime  count  is  che^ke 
by  the  current  module  against  the  number  of  lines  per  page,  when  the  maximum  lines  per  page 
reached  a  call  to  UTPAGE  causes  a  page  advance  on  the  system  output  file  and  the  totd  immber 
printed  lines  is  updated.  The  header  information  can  be  modified  by  the  application  modules  by  smply 
overwriting  the  current  entries  in  the  OUTPT2  common  block.  Note  that  aU  system  output  should  be 
performed  using  this  utility  module. 

The  UTPAG2  routine  performs  a  page  eject  if  the  N  lines  will  not  fit  on  the  current  page. 

Design  Requirements: 

None 


Error  Conditions: 
None 
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Application  Utility  Module:  UTRPRT 
Entry  Point:  UTRPRT 


Purpose: 

Ib  print  the  contents  of  database  relational  entities  to  the  system  output  file. 

MAPOL  Calling  Sequence: 

CALL  UTRPRT  {  RELl,  REL2,  RELIO  ) 

Application  Calling  Sequence: 

CALL  UTRPRT  (  REL,  IKOR,  RKOR,  DKOR  ) 

rel  Relation  to  be  printed  (character, Input) 

iKOR,  RKOR,  Dynamic  memory  base  addresses  (Integer,  Real  and  Double,  Input) 

DKOR 

Method: 

The  relational  entity  RELi  is  printed  using  the  full  relation  projection.  At  present,  if  the  full  projection 
is  too  large  to  be  output  on  one  132  character  record,  the  remaining  attributes  are  ignored.  Each 
attribute,  regardless  of  type,  uses  a  12  character  format  for  output.  The  current  version  of  UTRPRT  h^ 
a  few  additional  restrictions.  The  first  is  that  any  string  attribute  that  is  more  than  eight  characters  in 
length  cannot  be  printed.  The  routine  will  ignore  these  attributes  and  write  a  message  to  that  effect.  In 
addition,  double-precision  attributes  are  first  converted  to  single-precision  before  output. 

Design  Requirements: 

1.  Only  the  following  attribute  types  are  supported: 

INT,  KINT,  AINT 
RSP,  ARSP 
RDP 

STR,  KSTR  (first  8  characters  only) 

Error  Conditions: 

1.  Relational  entity  REL  does  not  exist. 

2.  Relational  entity  REL  is  empty. 

3.  A  string  attribute  cannot  be  printed  when  longer  than  eight  characters. 
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Application  Utility  Module:  UTRSRT 

Entry  Point:  UTRSRT 

Purpose: 

Tb  sort  a  table  of  numbers  on  a  real  column  of  the  table 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 


CALL  UTRSRT 
I  SORT 
ITBROW 

BOTLIM 

TOFLIH 

KEYFOS 

TOTLEN 


(  ISORT/  ITBROW/  BOTLIM/  TOFLIM/  KEYFOS/  TOTLEN  ) 

Array  to  be  sorted  (Any,  Input) 

An  array  of  length  totlen  single-precision  words  used  to  store  a  table 
row  (Any,  Input) 

The  location  in  the  ISORT  array  of  the  first  word  of  the  first  entry  to  be 
sorted  (Integer,  Input) 

The  location  in  the  ISORT  array  of  the  last  word  of  the  last  entry  to  be 
sorted  (Integer,  Input) 

The  column  in  the  table  on  which  the  sort  occurs.  It  must  be  a  value  be¬ 
tween  1  and  TOTLEN  (Integer,  Input) 

The  length  in  single-precision  words  of  one  table  row  (Integer,  Input) 


Method: 

The  UTRSRT  routine  uses  a  QUICKSORT  algorithm  outlined  in  "The  Art  Of  Computer  Programming, 
Volume  3  /  Sorting  And  Searching"  by  D.E.  Knuth,  Page  116.  Several  improvements  have  been  made 
over  the  pure  quicksort  algorithm.  The  first  is  a  random  selection  of  the  key  value  around  w^ch  the 
array  is  sorted.  This  feature  allows  this  routine  to  handle  partially  sorted  information  more  rapidly  than 
the  pure  quicksort  algorithm.  The  second  improvement  in  this  routine  is  that  a  cutoff  array  length  is 
used  to  direct  further  array  sorting  to  an  insert  sort  algorithm  (Ibid.  Page  81).  This  method  has  proven 
to  be  more  rapid  than  allowing  small  arrays  to  be  sorted  by  the  quicksort  algorithm.  Presently  this  cutoff 
length  is  set  at  15  entries.  Studies  should  be  conducted  on  each  type  of  machine  in  order  to  set  this  cutoff 
length  to  maximize  the  speed  of  this  routine.  This  sorting  algorithm  requires  a  integer  stack  in  which 
to  place  link  information  during  the  sort.  The  maximum  required  size  for  this  stack  array  in  twice  the 
natural  log  of  the  number  of  rows  in  the  table.  At  present,  the  UTRSRT  routine  has  hard  coded  an  array 
of  size  (2/40)  which  provides  for  1  trillion  entries  to  be  sorted. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module:  UTSFLG,  UTSFLR,  UTGFLG,  UTGFLR 
Entry  Points:  UTSFLG,  UTSFLR,  UTGFLG,  UTGFLR 


Purpose: 

These  routines  set  a  named  flag  to  an  integer  value,  real  value,  or  retrieve  a  value  previously  set. 
MAPOL  Calling  Sequence: 


None 

Application  Calling  Sequence: 

CALL  UTSFLG (  INNAME  ,  INVAL  } 
CALL  UTSFLR  (  INUAME  ,  INVALR  ) 
CALL  UTGFLG (  INNAME  ,  OUTVAL  ) 
CALL  UTGFLR (  INNAME  ,  OUTVLR  ) 


INNAME 

INVAL 

INVALR 

OUTVAL 

OUTVLR 


The  name  of  the  FLAG  to  set  (Character,Input) 
The  value  to  set  for  the  flag  (Integer,Input) 
The  value  to  set  for  the  FI*AG  (Real,Input) 

The  current  value  of  the  flag  (Integer,Output) 
The  current  value  of  the  FLAG  (Real,Output) 


Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 

Notes: 

1.  Routine  setsys  uses  UTSFLG  to  set  output  file  unit  niunber,  print  (set  to  second  word  of  /UNITS/ 
from  XXBU)  and  to  set  the  system  precision  PREC  (=1  for  single-precision;  =2  for  double-precision) 
based  on  the  double  function.  Large  matrix  utilities  fetch  these  flag  values  by  using  utgflg. 

2.  Some  of  the  debug  parameters  are  set  by  utsflg  and  are  retrieved  by  the  apphcation  modules 
using  UTGFLG. 

3.  Routine  TIMCOM  uses  UTSFLR  to  set  system  timing  constants  for  matrix  operations.  The  flags  are 
named:  TMUNIO,  TMMXPT,  TMMXUT,  TMMXPK,  TMMXUP,  TMMXUM,  TMMXPM,  TMTRSP,  TMTRDP, 
TMTCSP,  TMTCDP,  TMLRSP,  TMLRDP,  TMLCSP,  TMLCDP,  TMCRSP,  TMCRDP,  TMCCSP,  and 
TMCCDP.  Large  Matrix  utilities  fetch  these  constants  by  using  UTGFLR. 
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Application  Utility  Module:  UTSORT 
Entry  Point:  UTSORT 


Purpose: 

lb  sort  a  table  of  data  on  an  integer  coliimn  of  the  table 
MAPOL  Calling  Sequence: 

None 


Application  Calling  Sequence: 

raT.T.  XJTSORT  (  ISORT,  ITBROW,  BOTLIM,  TOPLIM,  KEYPOS,  TOTLEN  ) 


ISORT 

ITBROW 

BOTLIM 

TOPLIM 

KEYPOS 

TOTLEN 


Array  to  be  sorted  (Any,  Input) 

An  array  of  length  TOTLEN  single-precision  words  used  to  store  a  table 
row  (Any,  Input) 

The  location  in  the  ISORT  array  of  the  first  word  of  the  first  entry  to  be 
sorted  (Integer,  Input) 

The  location  in  the  isORT  array  of  the  last  word  of  the  last  entry  to  be 
sorted  (Integer,  Input) 

The  column  in  the  table  on  which  the  sort  occurs.  It  must  be  a  value  be¬ 
tween  1  and  TOTLEN.  (Integer,  Input) 

The  length  in  single-precision  words  of  one  table  row  (Integer,  Input) 


Method: 

The  UTSORT  routine  uses  a  QUICKSORT  algorithm  outlined  in  "The  Art  Of  Computer  Programming, 
Volume  3  /  Sorting  And  Searching"  by  D.E.  Knuth,  Page  116.  Several  improvements  have  been  made 
over  the  pure  quicksort  algorithm.  The  first  is  a  random  selection  of  the  key  value  around  w^ch  the 
array  is  sorted.  This  feature  allows  this  routine  to  handle  partially  sorted  information  more  rapidly  than 
the  pure  quicksort  algorithm.  The  second  improvement  in  this  routine  is  that  a  cutoff  array  length  is 
used  to  direct  further  array  sorting  to  an  insert  sort  algorithm  (Ibid.  Page  81).  This  method  has  proven 
to  be  more  rapid  than  allowing  small  arrays  to  be  sorted  by  the  quicksort  algorithm.  Presently  this  cutoff 
length  is  set  at  15  entries.  Studies  should  be  conducted  on  each  type  of  machine  in  order  to  set  this  cutoff 
length  to  maximize  the  speed  of  this  routine.  This  sorting  algorithm  requires  a  integer  stack  in  which 
to  place  link  information  during  the  sort.  The  maximum  required  size  for  this  stack  array  in  twice  the 
natural  log  of  the  number  of  rows  in  the  table.  At  present,  the  UTSORT  routine  has  hard  coded  an  array 
of  size  (2,40)  which  provides  for  1  trilUon  entries  to  be  sorted. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module:  UTSRCH 
Entry  Point:  UTSRCH 


Purpose: 

Search  a  table  of  values  for  an  integer  key  from  a  table  that  is  in  sorted  order  on  that  integer  key. 


Application  Calling  Sequence: 


CALL  UTSRCH  ( 
♦ERR 
KEY 
LIST 
LENT 

LSTLEN 

INCR 


♦ERR,  KEY,  LIST,  LPMT,  LSTLEN,  INCR  ) 

Error  return  if  the  KEY  value  is  not  found  in  the  LIST. 

Value  being  searched  for  in  the  LIST  (Integer,  Input) 

Array  in  which  the  KEY  should  be  located  (Any,  Input) 

On  input,  the  pointer  to  the  lowest  key  value  in  the  LIST  .  On  output, 
pointer  to  the  matching  value  in  the  LIST  (Integer) 

Length  of  the  hst  including  INCR  - 1  trailing  values  following  the  last  key 
(Integer,  Input) 

The  spacing  in  the  LIST  between  key  values  (Integer,  Input) 


Method: 

The  UTSRCH  routine  first  calculates  the  munber  of  key  values  to  be  searched.  If  there  are  less  than  a 
minimum  number  of  key  values  (presently  15),  then  the  list  is  searched  sequentially.  If  more  than  the 
minimum  exist,  a  binary  search  of  the  list  is  performed.  If  the  value  cannot  be  found,  the  routine  returns 
to  ♦ERR. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module:  UTSRT3 
Entry  Point:  UTSRT3 


Sort  a  table  on  one  to  three  integer  keys. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence,: 

CALL  UTSRT3  (  Z,  NENT,  LENT,  ZZ,  KEYl,  LKEYl,  KEY2,  LKEY2,  KEY3,  LKEY3,  TYPE  ) 

z  Array  to  be  sorted  (Any,  Input) 

NEOT  Th®  number  of  rows  (entries)  in  Z.  (Integer,  Input) 

Leut  The  number  of  words  in  each  row  of  z  (Integer,  Input) 

22  An  array  of  length  lent  to  be  used  as  intermediate  storage 

(Integer,  Input) 

Word  offset  in  Z  for  the  first  key  on  which  to  sort.  KEYl  must  be  in  the 
range  1  to  LENT  (Integer,  Input) 

Leey  1  Number  of  words  in  the  first  key  on  which  to  sort;  use  0  if  key  is  not 

used.  KEYl  +  LKEYl  must  be  less  than  lent  (Integer,  Input) 

IJJJ.Y2  Number  of  words  in  the  second  key  on  which  to  sort;  use  0  if  key  is  not 

used.  KEY2  +  LKEY2  must  be  less  than  LENT  (Integer,  Input) 

LEEY3  Number  of  words  in  the  third  key  on  which  to  sort;  use  0  if  KEY  is  not 

used.  KEY3  +  LKEY3  must  be  less  than  lent  (Integer,  Input) 

ipYPE  Type  of  sort  to  perform  (Integer,  Input) 

>  0  for  sorting  in  increasing  order 
<  0  for  sorting  in  decreasing  order 

Method: 

The  OTSRT3  routine  sorts  each  key  in  order  from  one  to  three,  with  multiple-word  keys  b^g  treated 
as  though  they  were  distinct  integer  keys  on  which  the  ascending  or  descending  sort  is  performed. 

Design  Requirements: 

1.  There  is  an  implementation  limit  of  no  more  than  200  total  keys. 


LKEY2 


LKEY3 


LKEYl  +  LKEY2  +  LKEY3  <  201 


Error  Conditions: 


1.  Tbo  many  sort  keys  cause  ASTROS  termination. 
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Application  Utility  Module:  UTSRTD 
Entry  Point:  UTSRTD 

Purpose: 

Sort  a  vector  of  double-precision  numbers. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  UTSRTD  (  Z,  BOTLIM,  TOPLIM  ) 

Z  Double  precision  array  to  be  sorted  (Double,  Input) 

botlim  The  location  in  the  Z  array  of  the  first  entry  to  be  sorted  (Integer,  Input) 

TOPLIM  The  location  in  the  z  array  of  the  last  entry  to  be  sorted  (Integer,  Input) 

Method: 

The  UTSRTD  routine  uses  a  QUICKSORT  algorithm  outlined  in  "The  Art  Of  Computer  Programming, 
Volume  3  /  Sorting  And  Searching"  by  D.E.  Knuth,  Page  116.  Several  improvements  have  been  made 
over  the  pure  quicksort  algorithm.  The  first  is  a  random  selection  of  the  key  value  around  which  the 
array  is  sorted.  This  feature  allows  this  routine  to  handle  partially  sorted  information  more  rapidly  than 
the  pure  quicksort  algorithm.  The  second  improvement  in  this  routine  is  that  a  cutoff  array  length  is 
used  to  direct  further  array  sorting  to  an  insert  sort  algorithm  (Ibid.  Page  81).  This  method  has  proven 
to  be  more  rapid  than  allowing  small  arrays  to  be  sorted  by  the  quicksort  algorithm.  Presently  this  cutoff 
length  is  set  at  15  entries.  Studies  should  be  conducted  on  each  type  of  machine  in  order  to  set  this  cutoff 
length  to  maximize  the  speed  of  this  routine.  The  algorithm  used  in  this  utility  requires  a  stack  array 
for  storing  the  linking  information  generated  during  the  sort.  The  maximum  size  needed  for  this  stack 
is  twice  the  natural  log  of  the  number  of  entries  in  the  array.  Currently,  a  stack  of  dimension  (2,40)  is 
hard  coded  which  allows  for  a  trillion  entries  to  be  sorted. 


Design  Requirements: 
None 

Error  Conditions: 
None 
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Application  Utility  Module;  UTSRTI 
Entry  Point:  UTSRTI 


Purpose: 

Sort  a  vector  of  integers. 
MAPOL  Calling  Sequence: 
None 

Application  Calling  Sequence: 


CALL  XrrSRTI 
z 

BOTLIM 

TOPLIM 


(  Z,  BOTLIM,  TOPLIM  ) 

Integer  array  to  be  sorted  (Integer,  Input) 

The  location  in  the  z  array  of  the  first  entry  to  be  sorted  (Integer,  Input) 
The  location  in  the  z  array  of  the  last  entry  to  be  sorted  (Integer,  Input) 


Method: 


The  UTSRTI  routine  uses  a  QUICKSORT  algorithm  outlined  in  "The  Art  Of  Computer  Programmmg, 
Volume  3  /  Sorting  And  Searching"  by  D.E.  Knuth,  Page  116.  Several  improvements  have  been  made 
over  the  pure  quicksort  algorithm.  The  first  is  a  random  selection  of  the  key  value  around  w^ch  ^e 
array  is  sorted.  This  feature  allows  this  routine  to  handle  partially  sorted  information  i^re  rapidl^han 
.ae  pure  quicksort  algorithm.  The  second  improvement  in  this  routine  is  that  a  cutoff  ^ay  length  is 
used  to  direct  further  array  sorting  to  an  insert  sort  algorithm  (Ibid.  Page  8 1).  ^s  method  has  proven 
to  be  more  rapid  than  allowing  small  arrays  to  be  sorted  by  the  quicksort  algorithm,  l^esently  tms  cuto 
length  is  set  at  15  entries.  Studies  should  be  conducted  on  each  type  of  machine  in  order  to  set  this  cutott 
lenrth  to  maximize  the  speed  of  this  routine.  The  algorithm  used  in  this  utility  reqmres  a  st^k  a^ay 
for  storing  the  linking  information  generated  during  the  sort.  The  maximum  size  needed  for  tins  stack 
is  twice  the  natural  log  of  the  number  of  entries  in  the  array.  Currently,  a  stack  of  dimension  (2,40)  is 
hard  coded  which  allows  for  a  trillion  entries  to  be  sorted. 


Design  Requirements: 
None 

Error  Conditions: 
None 
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Application  Utility  Module:  UTSRTR 
Entry  Point:  UTSRTR 


Purpose: 

Sort  a  vector  of  real  numbers. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  UTSRTR  (  Z,  BOTLIM,  TOPLIM  ) 

Z  Real  array  to  be  sorted  (Real,  Input) 

BOTLIM  The  location  in  the  z  array  of  the  first  entry  to  be  sorted  (Integer,  Input) 

TOPLIM  The  location  in  the  Z  array  of  the  last  entry  to  be  sorted  (Integer,  Input) 

Method: 

The  UTSRTR  routine  uses  a  QUICKSORT  algorithm  outlined  in  "The  Art  Of  Computer  Programming, 
Volume  3  /  Sorting  And  Searching"  by  D.E.  Enuth,  Page  116.  Several  improvements  have  been  made 
over  the  pure  quicksort  algorithm.  The  first  is  a  random  selection  of  the  key  value  around  which  the 
array  is  sorted.  This  feature  allows  this  routine  to  handle  partially  sorted  information  more  rapidly  than 
the  pure  quicksort  algorithm.  The  second  improvement  in  this  routine  is  that  a  cutoff  array  length  is 
used  to  direct  further  array  sorting  to  an  insert  sort  algorithm  (Ibid.  Page  81).  This  method  has  proven 
to  be  more  rapid  than  allowing  small  arrays  to  be  sorted  by  the  quicksort  algorithm.  Presently  this  cutoff 
length  is  set  at  15  entries.  Studies  should  be  conducted  on  each  type  of  machine  in  order  to  set  this  cutoff 
length  to  maximize  the  speed  of  this  routine.  The  algorithm  used  in  this  utility  requires  a  stack  array 
for  storing  the  linking  information  generated  during  the  sort.  The  maximum  size  needed  for  this  stack 
is  twice  the  natural  log  of  the  number  of  entries  in  the  array.  Currently,  a  stack  of  dimension  (2,40)  is 
hard  coded  which  allows  for  a  trillion  entries  to  be  sorted. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  utility  Module;  UTSTOD,  UTDTOS 
Entry  Point:  UTSTOD,  UTDTOS 


Purpose: 


-Ib  convert  a  number  of  entries  from  single-precision  to  double-precision  and  copy  them 

^to  another  and  to  convert  a  number  of  entries  from  double-precision  to  smgle-precision  and  copy  them 

from  one  array  into  another. 


MAPOL  Calling  Sequence: 
None 


Application  Calling  Sequence: 

f^&T.T.  UTSTOD  (  RZ,  DZ,  TOTLEN  ) 

nar.T.  UTDTOS  (  DZ,  RZ,  TOTLEN  ) 

RZ  Real  array  (Real, Input) 

Double  precision  array  (Double, Input) 


TOTLEN  Length  of  array  (Integer,Input) 


Method: 

For  DTSTOD,  TOTLEN  entries  of  array  RZ  ^e  copied  to  DZ  and  converted  to  double-precision. 
Similarly,  for  UTDTOS,  the  entries  of  DZ  are  copied  to  RZ . 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module:  UTUPRT 

Entry  Point:  UTUPRT 

Purpose: 

lb  print  the  contents  of  database  unstructured  entities  to  the  system  output  file. 

MAPOL  Calling  Sequence: 

CALL  UTUPRT  (  ENTNAM^  TYPE  ) 

ENTNAM  Entity  name  of  array  (Character, Input) 

TYPE  lype  of  format  to  use  in  printing  (Integer, Input) 

=  0  for  Integer 
=  1  for  Real 

=  2  for  Double  Precision 

Application  Calling  Sequence: 

None 

Method: 

The  unstructured  entity  ENTNAM  is  printed  to  the  system  output  file  using  the  format  specified  by  TYPE. 
The  available  formats  for  output  are:  0  for  Integer,  1  for  Real,  and  2  for  Double  Precision. 

Design  Requirements: 

None 

Error  Conditions: 

1.  Unstructured  entity  ENTNAM  does  not  exist. 

2.  Unstructured  entity  ENTNAM  is  empty. 

3.  Invalid  unstructured  type  $  in  UTUPRT  print  request  for  entity  $.  Valid  types  are:  0  ^  1,  2  (INT, 
RSP,  RDP;  respectively) 


318 


Application  Utility  Module:  UTZERD 
Entry  Point:  UTZERD 


Purpose: 

Tb  initialize  the  contents  of  an  array  with  a  specified  double-precision  value. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence^ 

CALL  UTZERD  (  ARRAY,  NWORDS,  VALUE  ) 

Name  of  array  (Double, Input  and  Output) 
uyjORDS  Length  of  array  in  words  (Integer, Input) 

Value  to  use  in  initializing  array  (Double,Input) 

Method: 

NWORDS  of  array  ARRAY  are  initialized  with  the  value  valot.  Note  that  value 
double-precision. 

Design  Requirements: 

None 

Error  Conditions: 

None 


and  ARRAY  must  be 
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Application  Utility  Module:  UTZERS 

Entry  Point:  UTZERS 

Purpose: 

Tb  initialize  the  contents  of  an  array  with  a  specified  integer  or  real  value. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  UTZERS  (  ARRAY,  NWORDS,  VALUE  ) 

ARRAY  Name  of  array  (Any, Input  and  Output) 

NWORUS  Length  of  array  in  words  (Integer, Input) 

VALUE  Value  to  use  in  initializing  array  (Integer  or  Real,Input) 

Method: 

MWORCS  of  array  array  are  initialized  with  the  value  VALUE.  Both  array  and  value  must  be 
single-precision 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Application  Utility  Module:  XISTOI 
Entry  Point:  XISTOI 


Purpose: 

lb  convert  a  string  to  its  integer  equivalent. 
MAFOL  Calling  Sequence: 


None 

Application  Calling  Sequence: 

CALL  XISTOI  (  STR,  IVALOE,  RC  ) 

Character  string  representing  an  integer  number  (Character, Input) 

IVALUE  Resulting  integer  number  (Integer, Output) 

RC  Return  Code  (Integer,Output) 

=  0  if  STR  contained  a  legal  integer 

s!  1  if  STR  contained  an  illegal  character 

=  2  if  STR  contained  an  illegal  integer  (overflow) 


Method: 

The  character  string  STR  is  cracked  one  digit  at  a  time  with  error  checks  made  against  the  machine 
mgy^TniiTn  mteger  to  ensure  that  the  resultant  IVALUE  is  a  legal  integer. 

Design  Requirements: 

1.  Legal  strings  may  contain  plus  (+),  minus  (-)  and  one  or  more  decimal  digits  from  0  through  9. 

Error  Conditions: 

1.  Return  codes 
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Application  Utility  Module:  XISTOR 
Entry  Point:  XISTOR 


Purpose: 

To  convert  a  string  to  its  real  equivalent. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  XISTOR  (  STR,  VALUE,  RC  ) 

STR  Character  string  representing  a  real  number  (Character, Input) 

VALUE  Resulting  real  number  (Real, Output) 

RC  Return  Code  (Integer,Output) 

=  0  if  STR  contained  a  legal  real  ntunber 
=  1  if  STR  contained  an  illegal  character 
=  2  if  STR  contained  an  overflow  value 
=  3  if  STR  contained  an  vmderflow  value 

Method: 

The  character  string  STR  is  cracked  into  its  three  component  parts:  the  leading  whole  number,  the 
fractional  digits  and  the  exponential  whole  nmnber.  Each  of  the  these  pieces  is  optional.  The  three  parts 
are  then  combined  to  form  the  real  number. 

Design  Requirements: 

1.  Legal  strings  may  contain  plus  (+),  minus  (- ) ,  one  or  more  decimal  digits  from  0  through  9  and  E 
or  D  and  must  contain  a  decimal  point  (.). 

2.  The  Bulk  Data  style  of  real  number  representation  is  fully  supported  as  is  the  FORTRAN  E,  F  and 
G  formats. 

Error  Conditions: 

1.  Return  codes 
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7.  LARGE  MATRIX  UTILITY  MODULES 


Finite  element  structural  analysis,  which  forms  the  core  of  the  ASTROS  system,  requires  a  suite 
of  utilities  for  matrix  operations  which  are  able  to  efficiently  handle  very  large,  often  sparse,  matrices. 
This  section  is  devoted  to  the  documentation  of  the  large  matrix  utihties  in  ASTROS,  the  designation 
large  comes  from  the  assumption  made  by  each  of  these  utilities  that  the  relevant  matrices  are  stored  on 
the  CADBB  database  and  will  be  operated  on  in  a  fashion  that  allows  them  to  be  of  arbitrary  order.  Other 
matrix  operations  are  available  in  the  general  utility  library  documented  in  Section  6  for  small  matrices 
stored  in  memory.  The  suite  of  large  matrix  utilities  in  ASTROS  includes  partition/merge  operations, 
decomposition  and  forward/backward  substitutions,  multiply/add  and  pure  addition  operations,  transpose 
operations  and  real  and  complex  eigenvalue  extraction. 

The  following  subsections  document  the  interface  to  the  large  matrix  utihties  in  two  formats: 
using  the  executive  system  (MAPOL)  and  using  the  FORTRAN  calling  sequence.  In  some  cases,  the 
MAPOL  language  supports  the  particular  matrix  operation  directly.  In  such  cases,  the  user  need  not 
make  a  call  to  the  particular  utihty,  instead,  the  MAPOL  compiler  automatically  generates  the  correct 
call  to  the  appropriate  utility.  These  direct  interfaces  are  so  indicated  in  the  documentation. 
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Large  Matrix  Utility  Module:  CDCOMP 
Entry  Point:  CDCOMP 


Purpose: 

To  decompose  a  complex  square  matrix  [A]  into  its  upper  and  lower  triangular  factors: 

lA]  =  [L]  [U] 


MAFOL  Calling  Sequence: 

CALL  DECOMP  ([A],  [L]  ,  [U] )  ; 


Note  that  the  calling  sequence  for  cdcomp  is  through  the  MAPOL  decomp  module.  The  method  is 
automatically  selected  if  the  input  matrix  is  complex. 

Application  Calling  Sequence: 

CALL  CDCOMP  (A,  L,  U,  IKOR,  RKOR,  DKOR) 


[A] 

[L] 

[U] 

IKOR, RKOR, DKOR 


The  matrix  to  be  decomposed  (Input,  Character) 

The  lower  triangular  factor  (Output,  Character) 

The  upper  triangular  factor  (Output,  Character) 

The  dynamic  memory  base  address  (Integer,Real  and  Double,Input) 


Method: 

The  CDCOMP  module  decomposes  complex  matrices.  The  resultant  lower,  [L] ,  and  upper,  [U] ,  triangular 
factors  are  specially  structured  matrix  entities  having  control  information  in  the  diagonal  terms.  They 
may  only  be  reliably  used  by  the  back-substitution  module  6FBS. 

Design  Requirements: 

1.  The  back-substitution  phase  of  equation  solving  is  performed  with  module  gfbs. 

2.  The  triangular  factors  [L]  and  [U]  may  not  be  used  rehably  by  matrix  utihties  other  than  gfbs. 
Error  Conditions: 

None 
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Large  Matrix  Utility  Module:  CEIG 
Entry  Point:  CEIG 


Purpose: 

Tb  solve  the  equation: 

{[Mlp^  +  [B]p  +  [K]){U}  =  0 

for  the  eigenvalues  p  and  the  associated  eigenvectors  {11}  where  [M],  [B]  and  [K]  are  mass,  damping 

and  stifftiess  matrices,  respectively. 

MAPOL  Calling  Sequence: 

CALL  CEIG  (  SETID,  BCID,  USET,  [KDD] ,  [BDD] ,  [MDD] ,  LAMDAC,  [CPHID] , 

[CPHIDL],  NPHI  ); 


Application  Calling  Sequence: 


raT.T.  CEIG  (  SETID,  BCID,  USET,  KDD,  BDD,  HDD,  LAMDAC,  CPHID,  CPHIDL, 

OCEIGS,  IKOR,  RKOR,  DKOR  ) 

SETID  An  optional  set  identification  for  the  EIGC  entry.  Used  to  define  the  ex¬ 

traction  parentheses  if  omitted  from  MAPOL  or  0.  The  CASE  CMETHOD  at¬ 
tribute  will  define  the  SETID  used. 

BCID  The  boimdaiy  condition  identification  number  (Integer,  Input) 

USET  Entity  defining  structural  sets  for  the  current  BC 

[KDD]  Dynamic  stiffiiess  matrix  -  D-set  (Input,  Character) 

[BDD]  Dynamic  damping  matrix  -  D-set  (Input,  Character) 

[mdd]  Dynamic  mass  matrix  -  D-set  (Input,  Character) 

LAMDAC  A  relation  entity  containing  a  hst  of  extracted  complex  eigenvalues 

(Output,  Character) 

[CPHID]  A  matrix  whose  columns  are  the  complex  eigenvectors  corresponding  to 

the  extracted  eigenvalues  (Output,  Character) 


[CPHIDL] 

NPHI 

OCEIGS 

IKOR, RKOR, DKOR 


A  matrix  containing  the  left  complex  eigenvectors  (Output,  Character) 
The  nvunber  of  complex  eigenvectors  computed  (Output,  Integer) 

The  name  of  the  output  entity  for  statistical  information  (Character) 
The  djmamic  memory  base  address  (Integer,Real  and  Double, Input) 


Method: 

The  Complex  Eigenvalue  Analysis  Module  calculates  the  eigenvalues  and  eigenvectors  for  a  general 
system  which  may  have  complex  terms  in  the  mass,  damping  and  stiffiiess  matrices,  ^e  eigenvectors 
are  scaled  according  to  the  user  requested  normalization  scheme  (MAX  or  POiNT).The  eigenvalues  p  and 
the  eigenvectors  {u)  are  always  treated  as  complex.  These  data  are  related  to  the  ud  displacements  if 
a  direct  formulation  is  used  or  are  related  to  the  uh  displacements  if  a  modal  formulation  is  used. 

Presently,  the  complex  eigenvalue  analysis  is  used  by  manually  inserting  a  call  to  module  CEIG  in  the 
MAPOL  sequence.  The  relation  EIGC  wiU  be  automatically  retrieved  in  module  CEIG  and  the  first 


325 


method  that  appears  in  the  relation  will  control  the  extraction.  The  Inverse  Power  Method  or  the  Upper 
Hessenburg  Method  which  is  selected  hyEX(X  data  is  used  to  solve  the  eigenvalue  problem.  (Subroutines 
CINVPR  or  HESSl).  In  case  there  is  insufficient  core  for  Upper  Hessenburg  Method,  the  Inverse  Power 
Method  will  be  used  if  the  necessary  data  exist  on  EIGC. 


Requirements: 


1.  The  matrices  [KDD,  [bdd]  and  [MDD]  must  be  complex,  and  matrices  [bdd]  and  [CPHIDL]  are 
not  required. 


Error  Conditions: 


1.  EIGC  is  not  in  the  Bulk  Data  packet. 

2.  [KDD]  and/or  [mdd]  do  not  exist. 


3.  [KDD]  and  [MDD]  are  not  compatible. 

4.  [MDD]  is  singular  in  HESS  method. 
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Large  Matrix  Utility  Module:  COLMERGE 

Entry  Point:  MXMERG 

Purpose: 

Tb  merge  two  submatrices  into  a  single  matrix  [A]  column-wise: 
[A]  [All  A12] 

MAPOL  Calling  Sequence: 

CALL  COLMERGE  ([A],  [An],  [A12]  <  [CP]); 


Application  Calling  Sequence: 

CALL  MXMERG  (A/  All/  BLANK/  A12/  BLANK/  CP/  BLANK/  KORE) 


[A] 

[Aij] 

[CP] 

BLANK 

KORE 


The  resulting  merged  matrix  (Output,  Character) 

The  input  partitions  as  shown  above  (Input,  Character) 
The  column  partitioning  vector  (Input,  Character) 

A  character  blank  (Input,  Character) 

The  dynamic  memory  base  address  (Integer,Input) 


Method: 

The  partitioning  vector  [CP]  must  be  a  column  vector  containing  zero  and  nonzero  terms.  The  [All] 
partition  will  be  placed  in  [A]  at  positions  where  [CP]  is  zero,  and  the  [A12]  partition  is  placed  in  [A] 
at  positions  where  [CP]  is  nonzero.  If  either  of  the  partitions  [All]  or  [A12]  is  null,  it  may  be  omitted 
from  the  MAPOL  calling  sequence  or  a  BLANK  may  be  used  in  the  application  callmg  sequence. 


The  COLPART  large  matrix  utihty  module  performs  the  inverse  of  this  module. 
Design  Requirements: 

None 

Error  Conditions: 

None 
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Large  Matrix  Utility  Module:  COLPART 

Entry  Point:  MXPRTN 

Purpose: 

lb  partition  a  matrix  [A]  into  two  submatrices  column-wise: 

[A]  [All  A12] 

MAPOL  Calling  Sequence: 

CALL  COLPART  ([A],  [An],  [A12] ,  [CP]); 

Application  Calling  Sequence: 

CALL  MXPRTN  (A,  An,  BLANK,  A12,  BLANK,  CP,  BLANK,  KORB) 

[A]  The  matrix  being  partitioned  (Input,  Character) 

[ Aij  ]  The  resTilting  partitions  shown  above  (Output,  Character) 

[CP]  The  column  partitioning  vector  (Input,  Character) 

BLANK  A  character  blank  (Input,  Character) 

KORE  The  dynamic  memory  base  address  (Integer,Input) 

Method: 

The  partitioning  vector  [CP]  must  be  a  column  vector  containing  zero  and  nonzero  terms.  The  [All] 
partition  will  then  contain  those  columns  of  [A]  corresponding  to  a  zero  value  in  [CP] ,  and  the  [A12] 
partition  is  placed  in  [A]  at  positions  where  [CP]  is  nonzero.  If  either  partition  is  not  desired,  it  may 
be  omitted  from  the  MAPOL  calling  sequence  or  a  BLANK  may  be  used  in  the  application  calling  sequence. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Large  Matrix  Utility  Module:  decomp 

Entry  Point:  DECOMP 

Purpose: 

Tb  decompose  a  general  square  matrix  [A]  into  its  upper  and  lower  triangular  factors: 

[A]  =  [L]  [U] 

MAPOL  Calling  Sequence: 

CALL  DECOMP  ( [A] ,  [L] ,  [U] ) ; 

Application  Calling  Sequence: 

C&T.T.  DECOMP  (A,  L,  U,  IKOR,  RKOR,  DKOR) 

[A]  The  matrix  to  be  decomposed  (Input,  Character) 

[L]  The  lower  triangular  factor  (Output,  Character) 

[0]  The  upper  triangular  factor  (Output,  Character) 

IKOR,  RKOR,  DKOR  The  dynamic  memory  base  address  (Integer,  Real  and  Double,Input) 

Method: 

The  DECOMPmodule  can  decompose  both  real  and  complexmatrices. The  resultant  lower,  [L] ,  ^d  upper, 

[U] ,  triangular  factors  are  specially  structured  matrix  entities  haying  control  information  in  the 
diagonal  terms.  They  may  only  be  reUably  used  by  the  back-substitution  module  6FBS. 

Design  Requirements: 

1.  DECOMP  can  process  both  real  and  complex  machine-precision  matrices. 

2.  The  back-substitution  phase  of  equation  solving  is  performed  with  module  GFBS. 

3.  The  triangular  factors  [L]  and  [U]  may  not  be  used  reliably  by  matrix  utilities  other  than  GFBS. 

Error  Conditions: 

None 
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Large  Matrix  Utility  Module:  FBS 

Entry  Point:  FBS 

Purpose: 

Tb  perform  the  forwardhackward  substitution  phase  of  equation  solving  for  symmetric  matrices  that 
have  been  decomposed  with  module  SDCOMP. 

MAPOL  Calling  Sequence: 

CALL  FBS  ([L],  [RHS] ,  [ANS] ,  ISIGN) ; 


Application  Calling  Sequence: 

CALL  FBSS  (L,  KHS,  ANS,  ISIGN,  IKOR,  RKOR,  DKOR) 


[L] 

[RHS] 

[ANS] 

ISIGN 

IKOR, RKOR, DKOR 


The  lower  triangular  decomposition  factor  obtained  from  sdcomp 
(Input,  Character) 

The  matrix  of  right-hand  sides  of  the  equations  being  solved 
(Input,  Character) 

The  matrix  of  resulting  solutions  of  the  equations  (Output,  Character) 

Sign  of  the  right-hand  sides  in  [RHS]  (+1  for  positive,  -1  for  negative  ) 
(Input,  Integer) 

The  dynamic  memory  base  address  (Integer,  Real  and  Double,Input) 


Method: 

Given  a  real  symmetric  system  of  equations 
[K]  [X]  =  ±[P] 


the  SDCOMP  large  matrix  utility  is  used  to  compute 

[K]  =  [L][D][L]’' 

such  that  [D]  is  a  diagonal  matrix.  This  module  then  completes  the  solution  for  [x]  as 

[L]  [Y]  =  ±[P] 

[L]’^[X]  =  [D]'^  [Y] 

If  [RHS]  is  blank,  the  inverse  of  the  decomposed  matrix  will  be  returned  in  [ANS] . 
Design  Requirements: 

None 

Error  Conditions: 

None 
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Large  Matrix  Utility  Modxile:  GFBS 
Entry  Point:  GFBS 


Purpose: 

lb  perform  the  forward/backward  substitution  phase  of  equation  solving  for  general  matrices  that  have 
been  decomposed  with  module  decomp. 

MAPOL  Calling  Sequence: 

CALL  GFBS  ( [L] ,  [U] ,  [RHS] ,  [ANS] ,  ISIGN) ; 


Application  Calling  Sequence: 


CALL  GFBS  (L, 

[L]  ,  [U] 

[KHS] 

[ANSI 

ISIGN 

IKOR, RKOR, DKOR 


U,  RHS,  ANS,  ISIGN,  IKOR,  RKOR,  DKOR) 

The  names  of  the  lower  and  upper  triangular  decomposition  factors  from 
decomp  (Input,  Character) 

The  matrix  of  right-hand  sides  of  the  equation  being  solved 
(Input,  Character) 

The  matrix  of  resulting  solutions  of  the  equations  (Output,  Character) 

Sign  of  the  right-hand  sides  in  [ANS]  (Input,+1  for  positive,  -1  for  nega¬ 
tive)  (Input,  Integer) 

The  dynamic  memory  base  address  (Integer,  Real  and  Double, Input) 


Method: 

Given  a  general,  real,  or  complex  system  of  equations 
IK] [X]  =  ±[P] 

the  DECOMP  large  matrix  utility  is  used  to  compute 

[K]  =  [L][U] 

This  module  then  completes  the  solution  for  [X]  as: 

[L]  [Y]  =  ±[P] 

[U][X]  =  [Y] 

If  [RHS]  is  blank,  the  inverse  of  the  decomposed  matrix  will  be  returned  in  [ANS] . 
Design  Requirements: 

None 

Error  Conditions: 

None 
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Large  Matrix  Utility  Module:  MERGE 


Entry  Point:  MXMERG 
Purpose: 

To  merge  four  submatrices  into  a  single  matrix  [A]  based  on  one  or  two  partitioning  vectors. 

>  [A] 


‘All  I  Ai2 

A21  1  A22 


MAPOL  Calling  Sequence: 


CALL  MERGE 


([A],  [All],  [A21],  [A12],  [A22],  [CP],  [RP] ) ; 


Application  Calling  Sequence: 

CALL  MXMERG  (A,  All,  A21,  A12,  A22,  CP,  RP,  KORE) 

[A]  The  resulting  merged  matrix  (Output,  Character) 

[Ai  j  ]  The  input  partitions  as  shown  above  (Input,  Character) 

[RP]  The  row  partitioning  vector  (Input,  Character) 

[CP]  The  coliunn  partitioning  vector  (Input,  Character) 

KORE  The  dynamic  memory  base  address  (Integer,Input) 

Method: 

The  partitioning  vectors  [CP]  and  [RP]  must  be  column  vectors  containing  zero  and  nonzero  terms. 
The  [All]  partition  will  be  placed  in  [A]  at  positions  where  both  [RP]  and  [CP]  are  zero.  The  [A12] 
partition  will  be  placed  in  [A]  at  positions  where  [RP]  is  zero  and  [CP]  is  nonzero.  The  other  partitions 
are  treated  in  a  similar  manner. 

If  some  of  the  partitions  are  null,  they  may  be  omitted  from  the  MAPOL  calling  sequence  or  a  character 
blank  may  be  used  in  the  application  calling  sequence.  In  a  similar  manner,  if  the  row  and  column 
partition  vectors  are  the  same,  one  of  them  may  be  omitted  or  left  blank  in  the  MAPOL  call.  They  must 
both  be  present  in  the  application  call. 

If  a  row  or  column  merge  alone  is  required  in  the  MAPOL  sequence,  the  special  purpose  MAPOL  utilities 
ROWMERGE  and  COLMERGE  may  be  used. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Large  Matrix  Utility  Module:  MPYAD 

Entry  Point:  MPYAD 

Purpose: 

Tb  perform  the  general  matrix  multiply  and  add  operations  as  shown  below: 

(1)  [D]  =  ±[A] [B]±[C]  or  =±[A]IB] 

(2)  [D]  =  ±[A]^[B1±[C]  or  =  ±[A]’'[B] 

MAPOL  Calling  Sequence: 

None,  the  MAPOL  syntax  supports  algebraic  matrix  operations  directly 
ID]  :=  ±[A]*[B]  ±[C]; 

[D]  :=  ±TRANS([A])*[B]±[C1; 


Application  Calling  Sequence: 


CALL  MPYAD 
A 
B 
C 
D 

TFLAG 


SIGKAB 


(A,  B 


SXGNC 


IKOR,FKOR, 

DROR 


,  C,  D,  TFLAG,  SIGNAB,  SIGNC,  IKOR,  RKOR,  DKOR) 

The  name  of  the  input  A  matrix  (Character) 

The  name  of  the  input  B  matrix  (Character) 

The  name  of  the  input  C  matrix  or  blank  (Character) 

The  name  of  the  output  D  matrix  (Character) 

The  transpose  flag 
=  0  no  transpose 
=  1  transpose  matrix  A 
(Integer,  Input) 

The  sign  on  the  [A]  [B]  product 
=  +1  +IA1 [B] 

=  -1  -[A][B] 

(Integer,  Input) 

The  sign  on  the  [C]  matrix 
=  +1  +[C] 

=  0  no  IC]  matrix 
=  -1  -[Cl 
(Integer,  Input) 

The  dynamic  memory  base  address  (Integer,  Real  and  Double,Input) 
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Method: 


If  no  [C]  matrix  exists,  the  C  argument  should  be  blank  and  the  SIGNC  argument  should  be  zero. 
Design  Requirements: 

None 

Error  Conditions: 

None 


Large  Matrix  Utility  Module:  mxadd 

Entry  Point:  MXADD 

Purpose: 

lb  perform  the  general  matrix  addition  as  shown  below: 
[C]  =  a[Al  +  P[B] 


MAPOL  Calling  Sequence: 

None,  the  MAPOL  syntax  supports  algebraic  matrix  operations  directly. 
[C]  :=  (a)  [A]  ±  (P)  [B] 


Application  Calling  Sequence: 

CALL  MXADD  (A,  B,  C,  ALPHA,  BETA,  DKOR,  IKOR) 

A  The  name  of  the  input  A  matrix  (Character) 

B  The  name  of  the  input  B  matrix  (Character) 


c 

ALPHA 


BETA 

DKOR, IKOR 


The  name  of  the  output  C  matrix  (Character) 

The  constant  complex  multipher  of  matrix  A.  Real  array  of  length  2,  the 
first  word  is  the  real  part  of  the  constant,  the  second  is  the  imaginary 
part.  (Input,Complex) 

As  ALPHA  for  the  B  matrix.  (Input,Complex) 

The  dynamic  memory  base  address  (Double  and  Integer,Input) 


Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 


None 


Large  Matrix  Utility  Module:  PARTN 


I'oint:  MXPRTN 


To  partition  a  matrix  [A]  into  four  submatrices  based  on  one  or  two  partitioning  vectors: 


[A] 


All  Ai2 
A21  A22 


MAPOL  Calling  Sequence: 


CALL  PARTN 


([A],  [All],  [A21],  [A12],  [A22],  [CP],  [RP] ) ; 


Application  Calling  Sequence: 


CALL  MXPRTN 


[Ai  j  ] 


(A,  All,  A21,  A12,  A22,  CP,  RP,  KORE) 

The  matrix  to  be  partitioned  (Input,  Character) 

The  resulting  partitions  as  shown  above  (Output,  Character) 
The  row  partitioning  vector  (Input,  Character) 

The  column  partitioning  vector  (Input,  Character) 

The  dynamic  memory  base  address  (Integer, Input) 


Method: 


The  partitioning  vectors  [CP]  and  [RP]  must  be  column  vectors  containing  zero  and  nonzero  terms. 
The  [All]  partition  will  be  formed  from  [A]  at  positions  where  both  [RP]  and  [CP]  are  zero.  The 
[A12]  partition  will  be  formed  from  [A]  at  positions  where  [RP]  is  zero  and  [CP]  is  nonzero.  The  other 
partitions  are  treated  in  a  similar  manner. 

If  some  of  the  partitions  are  not  desired  as  output,  they  may  be  omitted  from  the  MAPOL  calling 
sequence  or  a  character  blank  may  be  used  in  the  application  calling  sequence.  In  a  similar  manner,  if 
the  row  and  column  partition  vectors  are  the  same,  one  of  them  may  be  omitted  or  left  blank  in  the 
MAPOL  call.  They  must  both  be  present  in  the  apphcation  call. 

If  a  simple  row  or  column  partition  is  required  in  the  MAPOL  sequence,  the  special  purpose  MAPOL 
utilities  ROWPART  and  COLPART  may  be  used. 

sign  Requirements: 


Error  Conditions: 
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Large  Matrix  Utility  Module:  REI6 

Entry  Point:  REIG 

Purpose: 

To  solve  the  equation: 

I  [K]  -  X[M]  ]{U}  =0 

for  its  eigenvalues,  X,  and  their  associated  eigenvectors  {<p). 
MAPOL  Calling  Sequence: 


CALL  REIG 

(ITER,  BCID,  USET  (BCID),  [K] ,  [M] ,  [MR],  [IM]  ,  LAMA, 

[PHI] ,  [MI] ,  NPHI) ; 

Application  Calling  Sequence: 

r^T.T.  REIG  (ITER,  BCID,  USET,  K,  M,  MR,  DM,  LAMA,  PHI,  MI, 

OEIGS,  KKOR,  DKOR) 

ITER 

The  design  iteration  nxunber  (Integer,  Input) 

BCID 

The  boundary  condition  identification  number  (Integer,  Input) 

USET 

The  entity  defining  structural  sets  for  the  current  boundary  condition 

[K]  ,  [M] 

The  stiffiiess  and  mass  matrices  (Input,  Character) 

[MR] 

The  rigid  body  mass  matrix  (Input,  Character) 

[DM] 

The  rigid  body  transformation  matrix  (Input,  Character) 

LAMA 

Relation  containing  a  Ust  of  extracted  eigenvalues  (Output,  Character) 

[PHI] 

A  matrix  whose  columns  are  the  eigenvectors  corresponding  to  the  ex¬ 
tracted  eigenvalues  (Output,  Character) 

[MI] 

The  modal  mass  matrix  (Output,  Character) 

NPHI 

The  number  of  eigenvectors  computed  (Integer,  Output) 

OEIGS 

The  name  of  the  output  entity  for  statistical  information  (Character) 

RKOR, DKOR 

The  d3m.amic  memory  base  address  (Real  and  Double, Input) 

Method: 

The  matrices  [K]  and  [M]  must  be  real  and  the  rigid  body  mass  matrix  [MR]  and  the  rigid  body 
transformation  matrix  [DM]  are  not  required.  The  REIG  module  must  query  the  CASE  relation^  entity 
to  determine  which  set  of  eigr  eigenvalue  extraction  data  to  use.  Because  of  the  multidisciplinary 
nature  of  the  code,  REIG  assumes  that,  if  called,  an  eigenanalysis  is  required.  It  uses  the  EIGR  data  that 
correspond  to  the  selection  for  the  current  boundary  condition,  BCID. 

Design  Reauirements: 

None 

Error  Conditions: 

None 
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Large  Matrix  Utility  Module:  ROVMERGE 


Entry  Point:  MXMERG 
Purpose: 

lb  merge  two  submatrices  into  a  single  matrix  [A]  row-wise: 


[A] 


All 

A21 


MAPOL  Calling  Sequence: 

CALL  ROWMERGE  ([A],  [All],  [A21] ,  [RP] ) ; 


Application  Calling  Sequence: 

CALL  MXMERG  (A,  All,  A21,  BLAMK,  BLAMK,  BLANK,  RP,  KORE) 

[A]  The  resulting  merged  matrix  (Output,  Character) 

[All] ,  [A21]  The  input  partitions  as  shown  above  (Input,  Character) 

[RP]  The  row  partitioning  vector  (Input,  Character) 

BLANK  A  character  blank  (Input,  Character) 

KORE  The  dynamic  memory  base  address  (Integer, Input) 

Method: 

The  partitioning  vector  [RP]  must  be  a  column  vector  containing  zero  and  nonzero  terms.  The  [All] 
partition  will  be  placed  in  [A]  at  positions  where  [RP]  is  zero.  If  either  of  the  partitions  [All]  or  [A12] 
is  null,  it  may  be  omitted  from  the  MAPOL  calling  sequence  or  a  blank  may  be  used  in  the  application 
calling  sequence. 

The  ROWPART  large  matrix  utility  module  performs  the  inverse  of  this  module. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Large  Matrix  Utility  Module;  ROWPART 
Entry  Point:  MXPRTN 


lb  partition  a  matrix  [A]  into  two  submatrices  row-wise: 


[A] 


MAPOL  Calling  Sequence: 

CALL  ROWPART  {  [A]  ,  [All]  ,  [A21]  ,  [RP]  )  ; 


Application  Calling  Sequence: 

fftT.T.  MXPRTN  (A,  All/  A21,  BLANK,  BLANK,  BLANK,  RP,  KORE) 

The  matrix  being  partitioned  (Input,  Character) 
j  ]  The  resulting  partitions  shown  above  (Output,  Character) 

[  RP  ]  The  partitioning  vector  (Input,  Character) 

blank  a  character  blank  (Input,  Character) 

R0RB  The  dynamic  memory  base  address  (Integer,Input) 


BIiANK 


Method: 

The  partitioning  vector  [RP]  must  be  a  column  vector  containing  zero  and  nonzero  terms.  The  [All! 

partition  will  then  contain  those  columns  of  [A]  corresponding  to  a  zero  value  in  [RP]  .If  either  portion 

is  not  desired  as  output,  it  may  be  omitted  from  the  MAPOL  calling  sequence  or  a  blank  may  be  used 
in  the  application  calling  sequence. 


Requirements: 


None 


Error  Conditions: 
None 
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Large  Matrix  Utility  Module:  SDCOMP 
Entry  Point:  SDCOMP 


Purpose: 

Tb  decompose  a  symmetric  square  matrix  [A]  into  the  form: 

[A]  ^  [L][D]IL]’^ 

where  [L]  is  a  lower  triangular  factor  and  the  diagonal  matrix  and  [D]  has  been  stored  on  the  diagonal 
of  [L]. 

MAPOL  Calling  Sequence: 

CALL  SDCOMP  ([A],  [L] ,  USET(BC),  SETNAM) ; 

Application  Calling  Sequence: 

CALL  SDCOMP  (A^  L^ 

[A] 

CL] 

CHLSKY 

USET 
SETMAM 

IKOR^RKOR,DKOR 

Method: 

The  SDCOMP  module  can  decompose  real  and  complex  symmetric  matrices.  The  resultant  lower  factor, 
[L] ,  is  a  specially  structured  matrix  entity  having  the  terms  of  [D]  on  the  diagonals.  It  may,  therefore, 
only  be  rehably  used  by  the  back-substitution  module,  FBS. 

Design  Requirements: 

None 

Error  Conditions: 

1.  Matrix  A  is  singular. 


CHLSKY^  USET^  SETNAM,  IKOR,  RKOR,  DKOR) 

The  matrix  to  be  decomposed  (Input) 

The  lower  triangular  factor  (Output) 

The  input  selection  of  Cholesky  decomposition 
=  0  no  Cholesky 
=  1  use  Cholesky 
(Integer) 

The  entity  defining  structural  sets  for  the  current  boundary  condition 
The  current  structural  set  name 

The  dynamic  memory  base  address  (Integer, Real  and  Double, Input) 
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Large  Matrix  Utility  Module:  TRNSPOSE 
Entry  Point:  TRNSPZ 


Purpose: 

Tb  generate  the  transpose  of  a  matrix. 

lA]  [A]"^ 

MAPQL  Calling  Sequence: 

CALL  TRNSPOSE  ( [A] ,  [ATRANS] ) ; 

Application  Calling  Sequence: 

CALL  TRNSPZ  (A,  ATRANS,  IKOR,  DKOR) 

The  name  of  the  input  matrix  to  be  transposed  (Input,  Character) 

The  name  of  the  resulting  transposed  matrix  (Output,  Character) 

The  dynamic  memory  base  address  (Integer  and  Double,Input) 

Method: 

The  output  matrix  entity,  [  atranS]  ,  must  already  exist  on  the  database.  It  will  be  flushed  and  loaded 
by  the  transpose  utility.  All  matrix  types  and  precisions  are  supported.  As  a  special  feature,  the  user 
controlled  11th  through  20th  words  of  the  info  array  for  the  input  matrix  are  copied  onto  the  transposed 
matrix. 

Design  Requirements: 

1.  The  spill  logic  for  the  utihty  has  a  limit  of  eight  scratch  files  to  perform  the  transpose.  If  the  transpose 
cannot  be  performed  in  eight  passes  using  the  available  memory,  the  utility  will  terminate. 

Error  Conditions: 

None 


[A] 

[ATRANS] 
IKOR, DKOR 
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8.  THE  CADDB  APPLICATION  INTERFACE 


The  Computer  Automated  Design  Database  (CADDB)  is  the  heart  of  the  ASTROS  software 
system  It  has  been  designed  to  provide  the  structures  and  access  features  typically  required  for  scientific 
software  applications  development.  CADDB  can  be  viewed  as  a  set  of  data  entities  that  are  accessible  by 
a  suite  of  utihty  routines  called  the  application  interface  as  shown  below: 


There  are  three  types  of  entities:  Unstructured,  Relational,  and  Matrix.  These  are  described 
individually  in  the  following  paragraphs. 

Unstructured  Entities. 

Unstructured  entities  form  the  least  organized  data  type  that  may  be  used.  An  unstructured 
entity  may  be  considered  as  a  set  of  variable  length  records  which  have  no  predetermined  structure  and 
which  may  or  may  not  have  any  relationship  with  each  other.  This  is  illustrated  by  the  following. 
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Unstructured  entities  are  t3^ically  used  when  "scratch"  space  is  needed  in  an  essentially  sequen¬ 
tial  manner.  Two  important  points,  however,  are  that  each  record  may  be  accessed  randomly  if  the  entity 
is  created  with  an  index  structure,  and  that  records  may  be  read  or  written  either  in  their  entirety  or  only 
partially.  Details  of  these  features  are  discussed  in  Subsection  8.6. 

Relational  Entities. 


Relational  entities  are  very  highly  structured  tables  of  data.  The  rows  of  the  table  are  called 
entries  or  tuples  and  the  columns  are  called  attributes,  as  shown  below: 
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The  definition  of  the  attributes  and  their  types  is  called  the  schema  of  the  relation.  Because  the 
schema  is  an  inherent  part  of  a  relation’s  data  structure,  each  attribute  may  be  referred  to  by  its  i^ame. 
In  addition,  because  each  of  the  attributes  is  independent  of  the  others,  it  is  possible  to  retrieve  or  modify 
only  selected  attributes  by  performing  &  projection  of  the  relation.  Attributes  may  also  be  defined  with 
keys.  If  an  attribute  is  keyed,  an  index  structure  is  built  that  allows  rapid  direct  access  to  a  given  entry. 
There  is  a  restriction,  however,  that  a  keyed  attribute  must  have  unique  values  for  all  entries. 

Another  powerful  feature  is  the  ability  to  retrieve  entries  that  have  been  qualified  by  one  or  more 
conditions.  A  condition  is  a  constraint  definition  for  an  attribute  value.  For  instance,  in  the  example 
above,  the  condition  of  X=1.0  might  be  specified  prior  to  data  retrieval.  Only  those  entries  that  satisfy  the 
given  constraint  or  constraints  are  then  returned. 

Relational  entities  are  used  when  the  data  they  contain  will  be  accessed  or  modified  on  a  selective 
basis.  This  eliminates  the  need  to  move  large  sequential  sets  of  data  back-and-forth  when  modifying  or 
retrieving  only  small  amounts  of  data.  An  additional  feature  available  with  CADDB  is  the  "blast"  access 
of  a  relation.  This  allows  the  data  to  be  treated  sequentially  while  maintaining  the  relational  form,  these 
and  other  features  are  fully  described  in  Section  8.5. 

Matrix  Entities. 

One  of  the  most  important  data  structures  encoimtered  in  engineering  applications  is  the  matrix. 
Matrix  algebra  forms  the  basis  for  the  finite  element  method  employed  by  ASTROS.  The  efficient  per¬ 
formance  of  this  algebra,  along  with  additional  operations  such  as  simultaneous  equation  solvers,  eigen- 
solvers  and  integration  schemes,  is  critical  to  such  a  software  system.  CADDB  represents  matrices  in 
packed  format.  This  format  has  been  used  extensively  by  the  NASTRAN  system  for  the  last  30  years 
with  excellent  success.  The  representation  of  a  matrix  on  CADDB  is  shown  below: 
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Referring  to  the  figure,  note  that  only  the  non-null  columns  of  a  matrix  are  stored,  thus  reducing 
Hi  sic  space  utihzation.  Within  each  column  are  one  or  more  strings.  A  string  is  a  sequential  burst  of  data 
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entities  with  a  header  that  indicates  the  first  row  position  of  the  data  in  the  given  column  and  "n",  the 
number  of  terms  in  the  string.  This  representation  allows  a  further  data  compression  in  that  zero  terms 
in  the  column  are  not  physically  stored. 

A  complete  library  of  matrix  utihties  is  available  within  the  ASTROS  system.  These  utihties  are 
coded  to  use  the  packed  format  to  its  best  advantage.  All  matrix  data  should  be  stored  in  this  manner. 
Many  access  methods  are  available  for  matrix  entities.  A  matrix  may  be  positioned  randomly  to  a  given 
column,  an  entire  column  may  be  read  or  written,  individual  terms  may  be  read  or  written  and  so  on. 
These  functions  are  described  in  Subsection  8.4. 


8.1.  CADDB  BASIC  DESIGN  CONCEPTS 

The  CADDB  implementation  was  influenced  by  three  fundamental  design  goals:  Open-endedness, 
performance,  and  structured  programming  methodology.  The  basic  internal  design  of  the  database  im¬ 
poses  no  imrealistic  restrictions.  A  virtually  imlimited  number  of  different  databases  and  entities  can  be 
processed  simultaneously  as  long  as  there  is  memory  to  hold  the  required  information.  The  only  fixed 
restrictions  are  those  imposed  by  the  computer  hardware  and  not  the  design.  For  example,  the  maximum 
number  of  blocks  in  the  entire  database  is  2^^  and  the  maximum  number  of  words  in  each  entity  is  also 
2^^  This  restriction  follows  fi-om  the  32-bit  word  length  of  some  of  the  target  machines. 

The  performance  goals  of  the  database  had  to  address  both  I/O  and  CPU  issues.  The  optimization 
of  I/O  performance  is  usually  in  direct  conflict  with  minimal  memory  utiUzation.  When  faced  with  an  VO 
versus  memory  conflict,  reduced  I/O  was  generally  selected.  Summarized  in  the  following  are  typical 
design  decisions  impacted  by  this  issue: 

1.  All  bit  maps  required  by  the  database  are  kept  in  memory  to  reduce  I/O  requirements  of  free 
block  management. 

2.  Directory  pointers  for  all  entities,  open  or  closed,  are  kept  in  memory  to  reduce  directory  search 
time. 

3.  While  any  t3^e  of  entity  is  open,  all  schema  definition  data  are  kept  in  memory. 

CADDB  was  designed  in  top-down  structured  manner.  It  is  divided  into  functional  modules  that 
simphfy  implementation,  testing,  and  maintenance.  Genetically,  the  functions  of  these  modules  are: 

1.  ENTITY  CODE:  Separate  groups  of  routines  are  provided  for  each  of  the  three  entity  types. 

2.  RELATIVE  BLOCK:  These  routines  process  the  block  allocation  tables  to  convert  relative  block 
numbers  used  by  entity  routines  into  physical  blocks. 

3.  BUFFER  MANAGEMENT:  All  buffer  management  is  done  by  these  routines. 

4.  FREE  BLOCK  MANAGEMENT;  Performs  the  allocating  and  freeing  of  physical  blocks. 

5.  INDEX  PROCESSING:  All  index  processing  is  done  by  these  routines.  Two  sets  of  routines,  one 
for  sequential  indices  and  one  for  binary  indices,  are  provided. 

6.  DIRECTORY:  A  separate  set  of  routine  is  provided  to  do  all  directory  processing. 

7.  MEMORY  MANAGEMENT.  All  memory  management  is  provided  by  these  routines. 

This  highly  modular  design  provides  several  advantages.  The  most  important  is  that  new  features  can  be 
added  with  a  minimal  effect  on  the  existing  code.  For  example,  a  double  buffering  scheme  could  be  added 
to  reduce  I/O  wait  time  by  simply  modifying  the  buffer  management  routines. 
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8.1  -1 .  Physical  Structure 


Each  physical  database  is  comprised  of  a  set  of  disk  files.  An  index  jSle  and  at  least  one  data  file 
are  required  for  each  database.  The  index  file  contains  the  necessary  control  information  to  find  entities 
on  the  database.  This  information  includes  the  following: 

1.  DIRECTORY:  Contains  information  required  to  process  each  entity. 

2.  FBBM:  The  Free  Block  Bit  Maps  (FBBM)  are  used  to  keep  track  of  the  blocks  which  are  allocated 
and  free. 

3.  BAT:  The  Block  Allocation  Table  (BAT)  is  used  to  keep  track  of  the  physical  blocks  used  by  each 
entity. 

4.  SCHEMA:  The  SCHEMA  defines  the  attribute  structure  for  each  relational  entity. 

5.  INDEX:  Each  matrix  or  unstructured  entity  can  have  optional  indices  built  to  allow  quick  access 
to  any  column  or  record.  Relational  entities  can  also  have  indices  built  for  any  attribute. 

The  data  files  are  used  to  store  the  actual  information  in  each  entity.  Multiple  data  files  can  be  used  to 
spMt  the  database  over  several  physical  disk  drives.  Free  block  allocation  is  performed  in  a  cyclic  fashion 
among  the  data  files  to  balance  the  I/O  load  on  the  system. 

8.1 .2.  Improvements  Over  Other  Databases 

The  design  of  a  new  ASTROS  database  was  required  to  address  deficiencies  in  existing  available 
codes.  The  GINO  I/O  system  of  NASTRAN,  while  efiicient,  is  a  file  management  system,  not  a  database. 
Separate  files  are  required  for  each  entity  and  only  matrix  and  unstructured  entities  are  supported.  The 
RIM  database,  developed  by  the  IPAD  program  for  NASA,  supports  the  relational  entity  type  but  does 
not  adequately  support  either  unstructured  or  matrix  types.  Additionally,  the  RIM  system  sudfiers  fi-om 
severe  restrictions  and  performance  penalties.  The  following  summarize  the  functional  improvements 
that  make  CADDB  superior  to  these  existing  systems: 

1.  The  three  entity  types  have  been  combined  into  one  database  in  as  consistent  a  manner  as 
possible. 

2.  The  dynamic  memory  manager  (See  Subsection  8.3)  allows  the  database  to  be  open-ended 
without  overburdening  an  application  code  which  also  makes  large  demands  on  memory. 

3.  Multiple  databases  and  as  many  entities  as  memory  allows  may  be  processed  simultaneously. 

4.  Multiple  jobs  can  have  READONLY  access  to  the  same  database.  With  CADDB,  a  system 
database,  as  described  in  Chapter  3.2,  is  provided.  This  database  contains  data  required  by  each 
ASTROS  job. 

5.  An  improvement  over  GINO  allows  existing  records  or  columns  of  xmstructured  and  matrix 
entities  to  be  rewritten  without  destroying  any  other  data  in  the  entity. 

6.  "Garbage-collection"  of  freed  blocks  is  handled  automatically  by  the  database.  The  dump  and 
restore  requirement  of  some  databases,  such  as  RIM,  is  eliminated. 


7.  The  concept  of  projections  has  been  added  to  all  relational  entity  access  calls.  This  allows 
application  codes  to  process  only  those  attributes  needed  for  each  entry  of  the  relation.  This 
allows  a  new  attribute  to  be  added  to  a  relation  without  impacting  previously  coded  modules 
not  requiring  the  new  attribute. 

8.1.3.  Memory  Requirements 

As  discussed  in  the  introduction  to  this  section,  trade-offs  in  design  between  memory  and  I/O 
performance  were  generaUy  made  in  favor  of  I/O.  In  this  subsection,  the  general  memory  requirements  of 
CADDB  are  summarized.  The  equations  below  use  the  following  symbols: 

I  the  index  block  file  size  in  words 
D  the  data  file  block  size  in  words 

E  the  number  of  entities  on  all  open  databases 

P  the  number  of  physical  files  in  the  database 

N  the  number  of  attributes  for  a  relation 

The  following  memory  is  required: 

1.  For  the  entity  name  table:  Mi  =  lOE 

2.  For  each  open  database:  M2  =  21  +  6P  +  I(P +1) 

3.  For  each  open  entity  without  indexing:  Ms  =  40  +  D  +  I 

4.  For  each  open  entity  with  indexing:  M4  =  40  +  D  +  31 

5.  For  each  relation,  an  additional  requirement  is:  Ms  =  49N 

Using  an  index  file  block  size  of  256  words  and  a  data  file  block  size  of  2,048  words,  fiiese 
relations  indicate  that,  for  a  typical  engineering  module,  the  memory  requirement  would  be  approxi¬ 
mately  4,000  words  greater  than  that  required  by  the  NASTRAN  GINO  system. 

This  is  felt  to  be  a  small  trade-off  for  the  significant  capabihty  enrichment. 
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8.2.  THE  GENERAL  UTILITIES 


There  are  nine  general  CADDB  utility  routines  as  shown  below: 


SUBROUTINE 

FUNCTION 

DBCREA 

Creates  a  database  entity 

DBOFEN 

Opens  a  database  entity  prior  to  I/O 

DBRENA 

Renames  a  database  entity 

DBEQUV 

Equiyalences  two  entity  names 

DBSWCH 

Interchanges  the  names  of  two  entities 

DBDEST 

Destroys,  or  removes,  an  entity  and  all  of  its  data  from  the  database 

DBFLSH 

Removes  the  data  contents  of  an  entity 

DBCLOS 

Tferminates  I/O  for  an  entity 

DBEXIS 

Checks  for  existence  of  an  entity 

DBNEMP 

Checks  for  existence  of  data  in  an  entity 

General  Utilities  are  those  which  apply  to  any  entity  t5^e.  Two  additional  general  data  utilities  are 
DBINIT  and  DBTERM.  These  are  system  level  modules  and  are  presented  in  Chapter  4. 

Creating  a  New  Entity. 


To  create  a  new  database  entity,  the  routine  DBCRZA.  is  used.  This  utility  enters  the  new  entity 
name  and  its  type  into  the  database  directoiy.  Although  there  are  three  entity  classes,  there  are  two 
options  for  both  matrix  and  unstructured  entities,  indexed  or  unindexed.  Typical  calls  to  create  the  three 
entities  pictured  in  Subsection  8.1  could  be: 


CALL 

DBCREA 

( 'GRID' , 

' REL ' ) 

CALL 

DBCREA 

( 'STUF' , 

'lUN' ) 

CALL 

DBCREA 

{ 'MATX' , 

'MAT' ) 

The  ASTROS  executive  system  automatically  creates  all  database  entities  that  are  declared  in 
the  MAPOL  program.  An  application  programmer  usually  creates  only  scratch  entities  within  a  given 
module. 

Accessins  Entities. 

Prior  to  adding  new  data,  modifying  existing  data  or  accessing  old  data  for  an  entity,  the  entity 
must  be  opened,  and  when  I/O  is  completed  it  must  be  closed.  This  is  done  to  allow  optional  use  of 
memory  resources  as  discussed  in  Subsection  8.1.  Using  the  examples  as  before,  I/O  is  initiated  by  the 
calls: 


CALL 

DBOPEN 

( ' GRID ' , 

INFO, 

'R/W'  , 

'FLUSH',  ISTAT) 

CALL 

DBOPEN 

('STUFF' 

,  INFO, 

'RO'  , 

'NOFLUSH',  ISTAT) 

CALL 

DBOPEN 

{'MAXT' , 

INFO, 

'R/W'  , 

'FLUSH',  ISTAT) 

The  array  info  is  very  important.  It  contains  20  words  that  provide  information  about  the  data 
contents  of  the  entity,  such  as  the  number  of  attributes  and  entries  in  a  relation,  the  number  of  records  in 
an  unstructured  entity  and  the  number  of  columns  in  a  matrix.  The  first  10  words  of  INFO  are  used  by 
the  database.  The  programmer  may  use  the  second  10  words  for  any  purpose  desired.  The  INFO  array  is 
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then  updated  when  the  entity  is  closed.  As  an  option,  access  to  an  entity  may  request  that  the  data 
contents  of  the  entity  be  destroyed,  or  FLUSHed,  when  opening  it. 


When  all  activity  is  completed  for  a  given  entity,  it  must  be  closed  to  free  memory  used  for  I/O. 
This  is  done  with  a  call  such  as; 

r  CALL  DBCLOS  ('GRID')  - 1 
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Database  General  Utility  Module:  DBCLOS 

Entry  Point:  DBCLOS 

Purpose: 

lb  terminate  I/O  from  a  specified  database  entity. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBCLOS  (  ENTUAM  ) 

ENTNAM  The  name  of  the  entity  (Character,  Input) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  General  Utility  Module:  DBCREA 
Entry  Point:  DBCREA 


Purpose: 

Tb  create  a  new  data  entity. 

MAFOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

rar.T.  PBCREA  {  ENTNAM,  TVPE  ) 

entnam  The  name  of  the  entity  (Character,  Input) 

type  The  entity  type  (Character,  Input) 


'REL' 

Relation 

'MAT' 

Matrix 

'IMAT' 

Indexed  matrix 

'UN' 

Unstructured 

'lUN' 

Indexed  unstructured 

Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 
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Database  General  Utility  Module:  DBDEST 

Entry  Point:  DBDEST 

Purpose: 

lb  destroy  a  database  entity,  removing  all  data  from  the  database  files  and  the  entity  name  from  the 
hst  of  entities. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CAIiL  DBDEST  {  ENTNAM  ) 

ENTNAM  The  name  of  the  entity  (Character,  Input) 

Method: 

None 

Design  Requirements: 

1.  ENTNAM  may  not  be  open. 

Error  Conditions: 

None 
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Database  General  Utility  Module:  DBEQUV 
Entry  Point:  DBEQUV 


Purpose: 

Ib  equivalence  two  entity  names  to  point  to  the  same  data.  After  a  dbequv  operation,  the  two  names 
are  synonymous.  The  only  way  to  break  an  established  equivalence  is  to  destroy  one  of  the  entities  which 
destroys  the  equivalences  along  with  the  entity  and  its  data. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBEQUV  (  MAMEl, 

MAMEl 
I1A11E2 


MAME2  ) 

Name  of  currently  existing  entity  (Character,  Input) 
Name  to  be  made  equivalent  to  NAMEl  (Character,  Input) 


Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 
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Database  General  Utility  Module:  DBEXIS 

Entry  Point:  DBEXIS 

Purpose: 

To  determine  if  a  given  entity  already  exists  on  the  database. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBEXIS  (  ENTNAM/  EXIST,  ITYPE  ) 

The  name  of  the  entity  (Character,  Input) 

Status  of  the  entity  (Integer,  Output) 

0  does  not  exist 

1  exists 

The  entity  type  (Integer,  Output) 

0  undefined  entity 

1  relation 

2  matrix 

3  indexed  matrix 

4  unstructured 

5  indexed  imstructured 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 


ENTNAM 

EXIST 

ITYPE 


None 


Database  General  Utility  Module:  DBFLSH 
Entry  Point:  DBFLSH 


Purpose: 

lb  delete,  or  flush  all  of  the  data  from  a  database  entity.  The  entity  itself  remains  in  existence,  but  is 
empty. 

MAPQL  Calling  Sequence: 

None 

AppHcation  Calling  Sequence: 

CALL  DBFLSH  (  ENTKAM  } 

ENTNAM  The  name  of  the  entity  (Character,  Input) 

Method: 

None 

Design  Requirements: 

1.  ENTNAM  may  not  open. 

Error  Conditions: 


None 


Database  General  Utility  Module:  DBNEMP 
Entry  Point:  DBNEMP 


Purpose: 

lb  return  a  logical  TRUE  or  FALSE  depending  on  whether  an  entity  has  entries,  records  or  columns 
(TRUE)  or  if  it  is  nonexistent  or  empty  (FALSE). 

MAFOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

DBNEMP  (  ENTNAH  ) 

entnam  The  name  of  the  entity  (Character,  Input) 

Method: 

DBMRMP  is  a  LOGICAL  FUNCTION  that  returns  true  if  and  only  if  the  named  entnam  exists  and 
contains  entries  if  relational,  columns  if  matrix  or  records  if  imstructured.  Any  other  condition  returns 
a  FALSE. 

Design  Requirements: 

1.  ENTNAM  may  not  open. 

Error  Conditions: 

None 
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Database  General  Utility  Module:  dbopen 
Entry  Point:  DBOPEN 


lb  open  a  database  entity  for  subsequent  I/O  operations. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBOPEN  (  ENTNAM,  INFO/  RW/  FLUSH,  ISTAT  ) 
ENTNAM  The  name  of  the  entity  (Charact 

INFO  Array  of  length  20  words  contai: 


The  name  of  the  entity  (Character,  Input) 

Array  of  length  20  words  containing  entity  information  (Integer,  Output) 

INFO  I  RELATION  |  MATRIX  UNSTRUCTURED 

1  TYPE  TYPE  TY'B'E _ 

2  NATTR  NCOL  _ NBEC _ 


NENTRY 


MAX  REC  LEN 

in  words 


PREC _ — 

DEN*100 _ — 

FORM _  — 

Maximum  number  of  _ 

nonzero  terms  in  any  column _ 

Maximum  number  of  strings  _ 

in  column _ 

Maximum  length  of  a  string  — 


DEN  is  measured  in  percent  ranging  from  0.0  to  1Q0>0 


Type  Codes  (TYPE)  are: 

1 

REL 

2 

NAT 

3 

IMAT 

4 

UN 

5 

lUN 

Form  Codes  (FORM)  are: 

1 

rectangular 

2 

S5nnmetric 

3 

diagonal 

4 

identity 

5 

square 

359 


Precision  Codes  (PREC)  are: 

1 

real,  single-precision 

2 

real,  double-precision 

3 

complex,  single-precision 

4 

complex,  double-precision 

RW  Type  of  access  (Character,  Input) 

'R/W'  ReadAVrite  access 

'  RO '  Read  only  access 

FLUSH  Flush  option  (Character,  Input) 

•  FLUSH '  flush  entity  on  open 

'NOFLUSH'  do  not  flush  entity  on  open 

ISTAT  Return  status  (Integer,  Output) 

0  entity  opened 

101  entity  does  not  exist 

Method: 

None 

Design  Requirements: 

1,  The  INFO  array  is  loaded  on  the  call  to  DBOPEN  and  not  subsequently  modified.  The  programmer 
may  use  the  second  10  words  for  any  purpose,  dbclos  will  write  the  current  INFO  data  to  the 
database. 

2.  Multiple  open  entities  must  not  share  info  array  locations.  Care  must  be  taken  not  to  modify  the 
first  10  words  within  the  application. 

Error  Conditions: 

None 


360 


361 


Database  General  Utility  Module:  DBSWCH 

Entry  Point:  DBSWCH 

Purpose: 

Tb  switch  the  names  of  two  database  entities. 

MAFOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DBSWCH  (  NAMEl  ,  IIA11E2  ) 

NAMEl  Name  of  first  entity  (Character,  Input) 

NAME2  Name  of  second  entity  (Character,  Input) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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8.3.  THE  DYNAMIC  MEMORY  MANAGER  UTILITIES 

The  dynamic  memory  manager  (DMM)  is  a  group  of  utility  routines  that  allow  the  apphcations 
programmer  to  work  with  open-ended  arrays  in  memory.  This  is  important  for  two  reasons.  The  first  is 
that  memory  is  not  wasted  by  fixed  length  FORTRAN  arrays.  The  second  reason  is  to  allow  algontlms  to 
use  spm-logic.  Spill-logic  is  code  that  can  perform  operations  on  only  that  portion  of  the  required  data 
that  fits  in  memory  at  a  given  time.  Free  memory,  (that  beyond  the  fixed  code  and  data  areas)  may  be 
organized  into  any  number  of  blocks,  and  groups  of  blocks,  as  shown  below. 


ALLOCATED  REGION  SIZE 


This  dynamic  memory  area  can  be  viewed  as  a  type  of  virtual  memory  those  paging  is  under  control  of 
the  programmer.  Static  memory  languages,  such  as  FORTRAN,  are  very  inefficient  users  of  memory.  The 
DMM  can  eliminate  some  of  this  inefficiency.  As  an  example,  consider  a  routine  to  perform  the  matrix 

addition 

[A]  +  [B]  =  [C] 
defined  by  the  equations 

Cij  =  Aij  +  Bij 
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Three  possible  implementations  are  shown,  all  based  on  the  assumption  that  the  available  mem¬ 
ory,  after  all  other  components  of  the  program  are  loaded,  is  30,000  words. 

The  Classical  FORTRAN  Approach. 

The  classical  brute-force  FORTRAN  solution  to  this  problem  is  to  see  that  3  arrays  each  dimen¬ 
sions  100  by  100  will  fit  perfectly  in  the  available  memory.  The  routine  is  duly  coded  as: 

DIMENSION  A  (100,  100),  B  (100,  100),  C  (100,  100) 

c 

C  ASSUME  THE  MATRICES  ARE  ALL  N*M 
C 

DO  200  1=1,  N 

DO  100  J=l,  M 

C(I,J)  =  A(I,J)  +  B(I,J) 

100  CONTINUE 

200  CONTINUE _ 


With  this  algorithm,  the  matrix  sizes  are  fixed  at  100  by  100.  If  the  matrices  are  only  3  by  3,  99 
plus  percent  of  the  memory  is  wasted.  Further,  although  a  20  by  500  matrix  would  occupy  the  same 
10,000  words,  it  cannot  fit  into  the  predefined  array.  This  latter  problem  can  easily  be  fixed  by  storing  the 
matrix  in  a  singly  dimensioned  array  of  10,000,  which  already  implies  the  programmer  must  manage  the 
array. 


By  using  the  dynamic  memory  manager  both  problems  shown  in  the  last  section  disappear. 
Consider  the  code  segment: 


COMMON/MEMORY/  Z  (1) 

C 

C  ALLOCATE  MEMORY  FOR  EACH  MATRIX 


CALL 

MMBASE 

( 

z  ) 

CALL 

MMGETB 

( 

'AMAT'  , 

'RSP' , 

N*M, 

'MAXT'  , 

lA, 

ISTAT 

) 

CALL 

MMGETB 

( 

'BMAT' , 

'RSP' , 

N*M, 

'MAXT'  , 

IB, 

ISTAT 

) 

CALL 

MMGETB 

( 

'CMAT' , 

' RSP ' , 

N*M, 

'MAXT'  , 

IC, 

ISTAT 

) 

DO  100  1=1,  N*M 
II  =  I  -  1 

Z  (  IC  +  II  )  =  Z  (  lA  +  II  )  +  Z  (  IB  +  II  ) 
100  CONTINUE _ 


This  code  allows  all  30,000  words  of  memory  to  be  used  regardless  of  the  shape  of  the  matrices.  Addition¬ 
ally,  it  uses  exactly  the  memory  required  if  the  operation  is  smaller  than  the  available  memory. 
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The  Smll-ln^ic  Approach. 

Spill-logic  can  be  implemented  in  a  number  of  ways  using  the  matrix  utHities  described  m 
Subsection  8.4.  When  spill-logic  is  used,  only  those  portions  of  the  matrices  involved  in  ^  operation  ^e 
brought  into  memory.  Operations  are  then  performed  and  intermediate  or  W  results  stor^  on  t  e 
database.  With  this  coding  technique,  problems  of  virtually  unlimited  size  may  be  addressed.  There  axe 
nine  DMM  utilities  that  may  be  used  by  an  application  programmer.  Each  routme  is  prefixed  with  the 


SUBROUTINE 

FUNCTION 

HMBASE 

HMBASC 

Used  by  each  module  to  define  the  location  of  the  memory  base  address 

MMDUMP 

Prints  a  table  of  allocated  memory  blocks 

HMFREE 

MMFREG 

Frees  allocated  memory  by  individual  blocks  or  by  groups  of  blocks 

MMGETB 

Gets  a  block  of  memory  of  the  specified  type  and  length  | 

MMREDU 

Reduces  the  size  of  a  block  J 

HMSQUZ 

Compresses  memory  I/O  areas 

MMSTAT 

Retiims  the  ma^Tniim  contiguous  memory  that  is  available  to  the  module  | 
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Database  Memory  Manager  Utility  Module;  MMBASC 
Entry  Point:  MMBASC 


Purpose: 

Tb  define  the  base  address  of  d3mamic  memory  that  contains  character  data. 

MAPOL  Calling  Sequence: 

None 

Apphcation  Calling  Sequence: 

CALL  MMBASC  (  ABAY,  LEN  ) 

ABAY  The  name  of  a  character  array  from  which  memory  pointers  will  be  meas¬ 

ured 

LEN  The  length  of  the  character  string  elements  in  abay 

Method: 

None 

Design  Requirements: 

1.  Only  one  call  to  MMBASC  may  be  made  in  a  module. 

Error  Conditions: 

None 
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NoneDatabase  Memory  Manager  Utility  Module;  mmbase 
Entry  Point:  MMBASE 


Purpose: 

Tb  define  the  base  address  of  dynamic  memory  of  reference  to  an  array. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MMBASE  (  ARAY  ) 

The  name  of  an  array  from  which  memory  pointers  will  be  measured 

Method: 

None 

Design  Requirements: 

1.  This  routine  must  be  the  first  called  in  each  module  that  uses  the  memory  manager. 

2.  It  cannot  be  used  for  memory  containing  character  data  (see  mmbasc). 

Error  Conditions: 

None 
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Database  Memory  Manager  Utility  Module:  MMDUMP 

Entry  Point:  MMDUUP 

Purpose: 

To  print  a  formatted  table  of  allocated  memory  blocks  to  the  output  file. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MMDUMP 

Method: 

None 

Design  Requirements: 

1.  The  utility  assumes  the  MMINIT  has  been  called  to  initialize  the  open  core  memory  block. 

2.  In  some  cases  of  corrupted  memory,  the  use  of  this  routine  may  result  in  an  infinite  loop. 
Error  Conditions: 

None 
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Database  Memory  Manager  Utility  Module:  MMFREE 
Entry  Point:  MMFREE 


Purpose: 

To  free  a  memory  block  for  subsequent  use. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MMFREE  (  BLK  ) 

BLK  Name  of  block  to  be  freed  (Character,  Input) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  Memory  Manager  Utility  Module:  MMFREG 


Entry  Point:  MMFREG 

Purpose: 

To 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MMFBR6  (  GRP  ) 

GRP  Name  of  the  group  of  blocks  to  be  freed  (Character,  Input) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  Memory  Manager  Utility  Module:  MMGETB 
Entry  Point:  MMGETB 


Purpose: 

lb  allocate  a  block  of  dynamic  memory. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MMGETB  (  BLK,  TYPE,  LEN,  GRP,  IPNT,  ISTAT  ) 

The  name  assigned  to  this  memory  block 

If  the  block  name  is  blank,  the  block  is  a  special  unnamed  memory  block 
in  that  it  can  only  be  freed  with  a  MMFREG  call  and  MMREDU  calls  are  not 
allowed  for  the  block.  (Character,  Input) 

The  data  type  of  the  memory  block:  (Character,  Input) 

'  RSP '  real,  single-precision  or  integer 

'  RDP '  real,  double-precision 

'CSP'  complex,  single-precision 

'CDP'  complex,  double-precision 

'  CHAR '  character 

Length  of  block  measured  in  the  imits  of  TYPE  (Integer,  Input) 

Name  defining  a  group  to  which  this  block  belongs  (Character,  Input) 

Pointer  to  the  allocated  block  of  memory  referenced  to  the  base  location 
(Integer,  Output) 

Status  return 

0  memory  successfully  allocated 

101  insufficient  memory  available 

Method: 

None 

Design  Requirements: 

1.  The  BLK  and  grp  names  are  truncated  to  a  length  of  four  characters.  Thus,  the  names  should  be 
unique  for  these  characters. 

Error  Conditions: 

1.  Attempt  to  allocate  a  memory  block  of  zero  length. 

2.  Attempt  to  allocate  a  duplicate  block/group  name. 


BLK 

TYPE 


LEN 

GRP 

IPNT 

ISTAT 
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Database  Memory  Manager  Utility  Module:  MMREDU 

Entry  Point:  MMREDU 

Purpose: 

Ib  reduce  the  size  of  a  memory  block  that  is  larger  than  needed. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 


CALL  MMREDU 

(  BLK,  TYPE,  LENGTH  } 

BLK 

The  name  assigned  to  this  memory  block  (Character,  Input) 

TYPE 

The  data  type  of  the  memory  block:  (Character,  Input) 

'RSP' 

real,  single-precision  or  integer 

'RDP' 

real,  double-precision 

^CSP' 

complex,  single-precision 

'CDP' 

complex,  double-precision 

'CHAR' 

character 

LENGTH 

Length  to 

be  freed  measured  in  units  of  TYPE  (Integer,  Input) 

Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 


1.  Attempt  to  reduce  memory  block  to  zero  length. 


Database  Memory  Manager  Utility  Module:  MMSQUZ 
Entry  Point:  MMSQUZ 


Purpose: 

lb  squeeze,  or  compress,  any  unused  I/O  buffer  space  used  by  the  database. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MMSQUZ 

Method: 

None 

Design  Requirements: 

1.  This  routine  should  not  be  used  within  an  application  routine,  it  is  an  executive  memory  manage¬ 
ment  function. 

Error  Conditions: 

None 
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Database  Memory  Manager  Utility  Module:  MMSTAT 
Entry  Point:  MMSTAT 


Purpose: 

Tb  determine  the  maximum  number  of  contiguous  single-precision  words  available  for  dynamic  alloca¬ 
tion. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MMSTST  (  CONTIG  ) 

CONTIG  The  maximum  number  of  contiguous  single-precision  words  available  (In¬ 

teger,  Output) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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8.4.  UTILITIES  FOR  MATRIX  ENTITIES 

The  matrix  entity  utilities  are  designed  to  provide  a  number  of  different  methods  for  accessing 
complete  columns,  portions  of  columns,  or  single  terms  of  a  matrix.  The  use  of  these  various  methods 
depends  on  the  source  of  data  defining  the  matrix  and  the  intensity  of  the  computational  algorithm.  The 
routines  available  are: 


SUBROUTINE 

FUNCTION 

MXINIT 

Initializes  a  matrix  entity  for  I/O 

MXFORM 

Change  the  form  of  a  matrix 

MXPOS 

Positions  to  a  specified  matrix  column 

MXRFOS 

MXNPOS 

HXSTAT 

Gets  matrix  column  information 

HXPAK 

Packs  a  column  of  a  matrix 

MXUNP 

Unpacks  a  column  of  a  matrix 

MXPKTI 

Packs  a  colvunn  of  a  matrix  either  term-by-term  or  by  partial 
column 

MXPKT 

MXPKTM 

MXPKTF 

MXUPTI 

Unpacks  a  coliimn  of  a  matrix  either  term-by-term  or  by  p^ial 
column 

MXUPT 

MXUPTM 

MXUPTF 

8.4.1.  Creating  a  Matrix. 

After  a  matrix  entity  has  been  created  it  must  be  initialized  before  it  can  be  used.  The  mxinit 
call  provides  information  required  for  the  storing  of  data  into  the  matrix.  For  example,  to  create  and 
initialize  a  matrix  entity  for  a  real,  single-precision,  symmetric  matrix  with  1,000  rows  the  following  code 
is  required: 

INTEGER  INFO  (20) 

CALL  DBCREA  ('KGG',  'MAT') 

CALL  DBOPEN  {'KGG',  INFO,'R/W',  'FLUSH',  ISTAT) 

CAT.T.  MXINIT  ('KGG',  1000,  'RSP',  'SYM') _ 

Whenever  a  matrix  is  flushed,  with  either  a  DBOPEN  or  a  DBFLSH  call,  the  initialization  data  are 
cleared.  Therefore,  an  MXINIT  call  is  required  before  reusing  the  matrix  in  this  case.  Similarly,  if  a 
matrix  entity  is  going  to  be  redefined,  it  must  be  flushed  before  a  new  mxinit  call  may  be  made. 
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8.4.2.  Packing  and  Unpacking  a  Matrix  by  Columns. 


The  simplest  method  to  process  a  matrix  is  with  the  full  column  routines  mxpak  and  mxunp.  Each 
of  these  routines  may  process  either  a  full  column  or  a  portion  of  a  column.  In  either  case,  only  one  call  is 
allowed  for  each  column.  The  subsequent  call  will  process  the  next  column.  The  following  code  illustrates 
the  packing  and  unpacking  of  matrix  by  columns: 


c 

c 

PACK  MATRIX  BY  COLUMNS 

c 

DO  100  ICOL  =  1,  NCOL 

CALL  MXPAK  ('KGG', 

COLDTA{l,ICOL) ,1,1000) 

100 

CONTINUE 

c 

c 

UNPACK  MATRIX  BY  COLUMNS 

c 

CALL  MXPOS  {'KGG',1) 

DO  200  ICOL  =  1,  NCOL 

CALL  MXUNP  ('KGG', 

DATA(l,ICOL) ,1,1000) 

200 

CONTINUE 

8.4.3.  Obtaining  Matrix  Column  Statistics. 

The  MXFAK  routine  removes  any  zero  terms  in  the  column  to  reduce  the  amoimt  of  disk  space 
required  to  store  the  matrix.  Consecutive  nonzero  terms  are  stored  in  strings.  Whenever  a  zero  term  is 
encountered,  the  current  string  is  terminated  and  a  new  string  is  started.  The  mxstat  routine  may  be 
used  to  obtain  statistics  about  each  column.  The  following  code  gives  an  example  of  how  this  information 
can  be  used  to  unpack  only  those  terms  between  the  first  and  last  nonzero  terms. 


DO  100  ICL  =  1,  NCOL 

CALL  MXSTAT  {'KGG',  COLID,  FNZ,  LNZ,  NZT,  DEN,  NSTR) 
CALL  MXUNP  ('KGG',  DATA,  FNZ,  LNZ -FNZ  +  1) 

100  CONTINUE 
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8.4.4.  Packing  and  Unpacking  a  Matrix  by  Terms. 

A  matrix  can  also  be  processed  by  individual  terms.  To  pack  a  matrix  termwise  requires  a  series 
of  calls  for  each  column.  The  first  call  must  be  a  column  initialization  call,  followed  by  a  series  of  calls  to 
pack  single  terms  and,  finally,  a  column  termination  call.  The  following  code  shows  the  packing  of  an 
individuaJ  matrix  column  by  terms; 


c 

c 

INITIALIZE  TERM-WISE  PACKING 

c 

CALL 

MXPKTI  ('KGG',  IKGG) 

c 

c 

READ 

MATRIX  TERM  AND  PACK 

c 

100 

READ 

(5,  END=200)  IROW,  VAL 

CALL 

MXPKT  (IKGG,  VAL,  IROW) 

GO  TO  100 

c 

c 

TERMINATE  COLUMN 

c 

200 

CALL 

MXPKTF  ('KGG') 

Note  that  the  termwise  packing  must  be  done  in  ascending  row  order. 

A  similar  set  of  Calls  is  required  to  unpack  a  matrix  by  terms.  The  MXSTAT  routine  is  used  to 
determine  the  number  of  nonzero  terms  that  exist  in  the  column.  The  following  code  will  unpack  and 
print  the  nonzero  terms  for  a  matrix  column. 


c 

DETERMINE  NUMBER  OF 

TERMS 

c 

c 

CALL  MXSTAT  ('KGG', 

COLID, 

FNZ,  LNZ, 

NZT,  DEN,  NSTR) 

c 

c 

START  UNPACKING  THE 

MATRIX 

COLUMN 

c 

CALL  MXUPTI  ('KGG', 
DO  100  ITERM=1,  NZT 

IKGG) 

CALL  MXUPT  (IKGG,  VAL, 

IROW) 

WRITE  (  6 , * )  ' ROW= ' ,  IROW ,  ' TERM= 

'  ,VAL 

100 

CONTINUE 

c 

c 

c 

CALL  MXUPTF  ( ' KGG ' ) 

It  is  not  required  that  each  term  m  the  column  be  unpacked.  If  any  terms  are  left,  the  MXUPTF  routine 
will  ignore  them  and  position  the  matrix  to  the  next  column. 
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8.4.5.  Packing  and  Unpacking  a  Matrix  by  Strings. 


As  explained  earlier,  matrix  data  are  actually  stored  in  strings  of  terms  with  intervening  zero 
terms  compressed.  A  series  of  routines  is  provided  to  allow  matrices  to  be  accessed  by  strings.  The  use  of 
these  routines  is  similar  to  the  termwise  routines  in  that  there  is  a  column  initialization  call,  a  call  for 
each  string,  and  a  column  termination  call.  The  following  code  shows  the  packing  of  a  matrix  which 
contains  two  strings,  the  first  with  five  terms  and  the  second  with  three  terms. 


c 

c 

c 

c 

c 

c 


c 

c 

c 


INITIALIZE  FOR  STRING  PACKING 

CALL  MXPKTI  ('KGG',  IKGG) 

PACK  OUT  TWO  STRINGS 

CALL  MXPKTM  (IKGG,  STRl,  10,  5) 
CALL  MXPKTM  (IKGG,  STR2 ,  20,  3) 

TERMINATE  STRING  PACKING 

CALL  MXPKTF  ( ' KGG '  ) _ 


Packing  a  column  by  strings  differs  in  several  respects  from  packing  by  columns.  First,  more  than 
one  MXPKTH  call  is  allowed  for  each  column.  With  HXFAK  only  one  call  per  column  is  allowed.  Secondly,  no 
compression  of  zero  terms  is  done  within  a  string.  This  feature  can  be  used  to  insure  that  certain  terms  of 
a  matrix  are  stored,  even  if  zero,  so  they  can  later  be  rewritten  randomly. 


The  tmpacking  of  a  matrix  by  strings  is  shown  in  the  following  code  example.  Note  the  use  of  the 
MXSTAT  routine  to  determine  the  number  of  strings  stored  in  the  column. 

c 

c  DETERMINE  THE  NUMBER  OF  STRINGS 

C 

CALL  MXSTAT  {'KGG',  COLID,  FNZ,  LNZ,  NZT,  DEN,  NSTR) 

C 

C  UNPACK  COLUMN  BY  STRINGS 

C 

CALL  MXPKTI  ('KGG',  IKGG) 

DO  100  1=1,  NSTR 

CALL  MXUPTM  ('KGG',  VALS,  IROW,  NROW) 

WRITE  (6,*)  'TERMS  FROM  ROW',  IROW,  'TO  ROW', 

*  IROW+NROW-1,  'ARE',  (VALS  (I),  1=1, NROW) 

100  CONTINUE 

C 

c  TERMINATE  COLUMN  UNPACKING 

C 

CALL  MXUPTF  ('KGG') _ 


It  is  important  that  MXSTAT  be  used  to  determine  the  number  of  strings  in  a  column  because, 
under  several  conditions,  the  number  may  be  different  from  the  number  of  strings  packed.  First,  if  the 
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string  packed  does  not  fit  in  the  current  buffer,  it  will  be  automatically  split  over  two  buffers.  Secondly,  if 
two  strings  are  packed  consecutively,  they  will  be  automatically  merged  mto  one  strmg  m  the  buffer. 

8.4.6.  Matrix  Positioning. 

Several  routines  are  provided  to  position  a  matrix  randomly  to  a  given  column.  This  operation 
can  be  done  on  either  indexed,  imat,  or  unindexed  matrices,  but  the  presence  of  an  mdex  speeds  up  the 
processing  greatly.  The  following  code  shows  the  use  of  these  routines  to  randomly  read  three  matrix 

columns. 


c  POSITION  TO  COLUMN  10  AND  UNPACK 

C 

CALL  MXPOS  ('KGG',  10) 

CALL  MXUNP  ('KGG',  DATA,  1,  1000) 

C 

C  POSITION  FORWARD  5  COLUMNS 

C 

CALL  MXRPOS  ('KGG',  +5) 

CALL  MXUNP  ('KGG',  DATA  ,  1,  1000) 

C 

C  POSITION  TO  NEXT  NONNULL  COLUMN 

C 

CALL  MXNPOS  ('KGG',  ICOL) 

_  CALL  MXUNP  ('KGG',  DATA,  1,  1000) _ _ 

The  first  MXDNP  retrieves  the  data  for  column  10  and  leaves  the  matrix  positioned  at  the  start  of 
column  11  The  MXRPOS  call  positions  the  matrix  forward  five  columns  to  column  16.  The  second  mxoot 
call  then  retrieves  the  data  for  column  16.  The  results  of  the  mxnpos  caU  depend  on  the  data  stored  m  the 
matrix  If  column  17  has  nonzero  terms,  it  will  be  positioned  there.  If  column  17  is  null,  the  matrix  m 
be  positioned  forward  untfi  a  nonnull  column  is  found.  Note  that  both  mxpos  and  mxrpos  require  that 
the  column  to  which  the  matrix  is  positioned  exists.  The  mxnpos,  utility  is  the  more  general  m  that  it 
determines  the  next  column  that  exists.  Null  matrix  columns  can  be  packed  m  two  ways.  The  following 
code  gives  examples  which  are  quite  different  in  that  the  first  example  creates  a  column  with  no  nonzero 
terms  while  the  second  example  creates  a  null  column  which  does  not  exist. 


c 

c 

CREATE  A  COLUMN  OF  ZEROS  WITH  MXPAK 

c 

CALL  MXPAK  ( 

'KGG',  0.0, 1,1) 

c 

c 

CREATE  NULL 

COLUMN 

c 

CALL  MXPKTI 

('KGG',  IKGG) 

CALL  MXPKTF 

( ' KGG ' ) 
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8.4.7.  Missing  Matrix  Columns. 


For  extremely  sparse  matrices  it  is  possible  to  pack  only  the  columns  which  contain  data.  This 
feature  can  greatly  reduce  disk  space  requirements  for  these  matrices  because  space  is  not  wasted  for 
column  headers  and  trailers.  It  also  simplifies  coding  because  it  is  not  required  to  pack  null  columns.  The 
following  example  shows  the  packing  of  an  extremely  sparse  matrix  which  contains  only  two  items. 


c 

c 

PACK 

DIAGONAL  TERM 

IN  COLUMN  100 

c 

CALL 

MXPOS  {'KGG', 

100) 

CALL 

MXPAK  ('KGG', 

1.0,100,1) 

c 

c 

PACK 

DIAGONAL  TERM 

IN  COLUMN  500 

c 

CALL 

MXPOS  ('KGG', 

500) 

CALL 

MXPAK  ('KGG', 

1.0,100,1) 

When  a  matrix  does  not  have  all  its  columns  stored,  care  must  be  used  when  unpacking  it.  Since 
the  routines  only  operate  on  columns  physically  stored  in  the  matrix  only  two  sets  of  calls  are  required  to 
impack  the  matrix. 

The  following  code  example  shows  one  method  of  unpacking  this  matrix. 


C 

C  UNPACK  TWO  MATRIX  COLUMNS 

C 

DO  100  ICOL  =1,2 

CALL  MXSTAT  ('KGG',  COLID,  FNZ ,  LNZ , NZT, DEN, NSTR) 
WRITE  (6,*)  'DATA  FOR  COLUMN',  COLID 
CALL  MXUNP  ('KGG',  DATA, 1,1000) 

100 _ CONTINUE  _ 


This  example  illustrates  a  disadvantage.  The  code  must  know  the  exact  number  of  columns 
stored  in  the  matrix.  There  is  no  method  provided  to  determine  this.  The  next  example  shows  how 
MXNPOS  can  be  used  to  produce  a  code  sequence  that  will  work  no  matter  how  many  physical  columns  are 
stored  in  the  matrix. 


C 

c 

c 

100 


POSITION  TO  NEXT  COLUMN 

CALL  MXNPOS  ('KGG', ICOL) 

IF  (  ICOL.GT.O  )  THEN 

WRITE  ( 6 , * )  ' DATA  FOR  COL ' ,  ICOL 

CALL  MXUNP  ('KGG',  DATA, 1,1000) 
GO  TO  100 
ENDIF 


The  MXPOS  and  MXRPOS  utilities  should  be  used  with  extreme  caution  if  the  matrix  does  not 
contain  all  physical  columns.  These  routines  work  on  actual  column  numbers  and  will  cause  fatal  errors  if 
the  column  does  not  exist.  For  example,  an  MXPOS  to  column  200  will  cause  an  error  because  the  column 
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is  not  stored  in  the  matrnc.  If  the  matrir  is  positioned  at  oolnnm  100,  an  MthPOS  of  +100  wffl  also  fail 
because  column  200  is  not  stored  in  the  matrix. 


8.4.8.  Repacking  a  Matrix. 


Once  a  matrix  has  been  packed,  it  is  possible  to  rewrite  certain  columns  of  the  mato  withrat 
disturbing  the  data  stored  in  any  other  columns.  The  only  restriction  is  that  the  topology  of  the  matrix 
terms  cannot  change.  For  example,  if  MXPAK  was  used  to  pack  the  column,  all  zero  terms  are  compressed^ 
Since  these  terms  are  not  physically  stored  in  the  matrix,  they  cannot  at  a  later  time  be  replaced  by  a 
nonzero  term.  This  can  be  avoided  by  using  the  termwise  or  strinpnse  'vhich  perfom  no  zero 
compression.  The  following  example  shows  the  packing  of  a  matrix  column  and  the  subsequent  repackmg 


of  it. 


c 

c 

c 


c 

c 

c 


c 

c 

c 


100 

c 

c 

c 


PACK  COLUMN  1  OF  MATRIX 

CALL  MXPOS  ( ' KGG ' ,1) 

CALL  MXPKTI  ('KGG',  IKGG) 

CALL  MXPKTM  (IKGG,  STR,  10,10) 

CALL  MXPKTF  ('KGG') 

READ  COLUMN  1  OF  MATRIX 

CALL  MXPOS  ( ' KGG ' , 1 ) 

CALL  MXPKTI  ('KGG',  IKGG) 

CALL  MXPKTM  (IKGG,  DATA, IROW,NROW) 
CALL  MXPKTF  ('KGG') 

DOUBLE  EACH  NUMBER  IN  THE  STRING 

DO  100  1=1,  NROW 

DATA  (I)=DATA  (I)  *  2.0 
CONTINUE 

REPLACE  THE  STRING 

CALL  MXPOS  ( ' KGG ' , 1 ) 

CALL  MXPKTI  ('KGG',  IKGG) 

CALL  MXPKTM  (IKGG,  DATA, IROW, NROW) 
CALL  MXPKTF  ('KGG') 


All  the  matrix  pack  utility  calls,  i.e.,  column,  term  and  string,  may  be  used  to  repack  matrix 
columns. 
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Database  Matrix  Utility  Module:  MXFORM 
Entry  Point:  MXFORM 


Purpose: 

Tb  change  the  form  of  a  matrix  entity. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MXFORM  (  NAME^  FORM  ) 

NAME  The  matrix  name  (Character,  Input) 

form  The  new  matrix  form  (Character,  Input) 


/REC' 

'SYM' 

'DIAG' 

'INDENT' 

'SQUARE' 


Rectangular 

Symmetric 

Diagonal 

Identity 

Square 


Method: 

None 

Design  Requirements: 

1.  MXFORM  may  be  called  any  time  after  the  creation  of  the  matrix. 
Error  Conditions: 

1.  Illegal  FORM  value;  error  MXFORMO 1. 
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Database  Matrix  Utility  Module:  MXINIT 
Entry  Point:  MXINIT 


Purpose: 

lb  initialize  a  matrix  prior  to  writing  data. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 


CALL  MXINIT 

(  MATMAM,  MROW,  PREC 

FORM  ) 

MATMAM 

Name  of  matrix  (Character,  Input) 

NKOW 

Number  of  rows  (Integer,  Input) 

PAEC 

The  precision 

of  the  matrix  (Character,  Input) 

'RSP' 

Real,  Single-precision 

'RDP' 

Real,  Double-precision 

'CSP' 

Complex,  Single-precision 

'CDP' 

Complex,  Double-precision 

FORM 

Form  of  the  matrix  (Character,  Input) 

'KEC' 

Rectangular 

'SYM' 

Symmetric 

'DIAG' 

Diagonal 

'INDENT' 

Identity 

'SQUARE' 

Square 

Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 
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Database  Matrix  Utility  Module;  MXNPOS 
Entry  Point:  MXNPOS 


To  position  a  matrix  to  the  next  nonnull  column. 
MAPOL  Calling  Sequence: 


Application  Calling  Sequence: 


CALL  MXNPOS  (  MATNAM,  ICOL  ) 


MATNAM 


Name  of  matrix  (Character,  Input) 

Column  number  positioned  to  (Integer,  Output) 


Method: 


Design  Requirements: 

1.  If  there  are  no  more  nonnull  columns  in  the  matrix,  ICOL  is  set  to  zero 
Error  Conditions: 
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Database  Matrix  Utility  Module:  MXPAK 
Entry  Point:  MXPAK 


Piirpose: 

To  pack  aU  ,  or  a  portion,  of  a  matrix  and  then  to  move  to  the  next  column. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 


CALL  MXPAK  (  MATNAM, 
MATNAM 
AKAY 
ROWl 
NROW 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 


ARAY,  ROWl/  NROW  ) 

Name  of  matrix  to  be  packed  (Character,  Input) 
Array  containing  data  to  be  packed  (Any  t3rpe.  Input) 
First  row  position  in  column  (Integer,  Input) 

Number  of  rows  to  pack  (Integer,  Input) 


None 


Database  Matrix  Utility  Module:  MXPKT 

Entry  Point:  MXPKT 

Purpose: 

To  pack  a  coliunn  of  a  matrix  one  term  at  a  time. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MXPKT  {  UNITID,  VAL,  IROW  ) 

UNITID  Unit  identification  fi-om  MXPKTI  call  (Integer,  Input) 

VAL  The  value  to  be  packed  (Any  type,  Input) 

IROW  The  row  position  of  the  term.  iROW  must  be  positive  and  greater  than  the 

value  in  any  previous  MXPKT  call  for  the  current  column  (Integer,  Input) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  Matrix  Utility  Module:  MXPKTF 

Entry  Point:  MXPKTF 

Pxirpose: 

lb  terminate  the  termwise  or  partial  packing  of  a  matrix  column. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MXPKTF  (  MATNAM  ) 


MATNAM 

Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 


Name  of  the  matrix  being  packed  (Character,  Input) 
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Database  Matrix  Utility  Module:  MXPKTI 
Entry  Point:  MXPKTI 


Purpose: 

To  initialize  a  matrix  column  for  term-by-term  or  partial  packing. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MXPKTI  (  MATNAM,  UNITID  ) 

MATNAM  Name  of  the  matrix  to  be  packed  (Character,  Input) 

UNITID  Unit  identifier  (Integer,  Output) 

Method: 

None 

Design  Requirements: 

1.  A  matrix  may  be  packed  by  columns  using  mxpak,  by  terms,  or  by  partial  columns,  but  not  by  any 
combination. 

Error  Conditions: 

None 
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Database  Matrix  Utility  Module;  mxpktm 
Entry  Point:  MXPKTM 


Purpose: 

Tb  pack  a  column  of  a  matrix  using  partial  columns. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MXPKTM  {  UNITID,  VALARR,  ROWl/  NROW  ) 

otiitid  Unit  identifier  from  MXPKTI  call  (Integer,  Input) 

valarr  Array  of  values  to  be  packed  (Any  type,  Input) 

RO;,!  Initial  row  position  of  VALARR  (Integer,  Input) 

Number  of  rows  to  be  packed  (Integer,  Input) 


Method: 

None 

Design  Requirements: 

1.  ROWl  and  NROW  must  be  positive. 


Error  Conditions: 
None 
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Database  Matrix  Utility  Module:  MXPOS 
Entry  Point:  MXPOS 


Purpose: 

To  position  a  matrix  to  a  specified  column. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MXPOS  (  HATMAM,  COL  ) 

MATNAM  Name  of  the  matrix  (Character,  Input) 

COL  Column  number  (Input,  Integer) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  Matrix  Utility  Module;  MXRPOS 
Entry  Point:  MXRPOS 


Purpose: 

Tb  position  a  matrix  to  a  column  by  specifying  the  column  increment  relative  to  the  current  column. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 


CALL  MXPOS  {  MATNAM, 
MATNAM 
DELCOL 


DELCOL  ) 

Name  of  the  matrix  (Character,  Input) 
Column  number  increment  (Integer,  Input) 


Method: 

None 

Design  Requirements: 

1.  Positive  DELCOL  positions  forward,  negative  position  backward  from  current  column. 

Error  Conditions: 

None 
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Database  Matrix  Utility  Module:  MXSTAT 


Entry  Point:  MXSTAT 


To  obtain  status  information  for  the  current  column. 
MAPOL  Calling  Sequence: 


Application  Calling  Sequence: 


CALL  MXSTAT  (  MATNAM,  COLID,  FNZ,  LNZ,  NZT,  DEN,  NSTR  ) 


MATNAM 


COLID 


Name  of  the  matrix  (Character,  Input) 

Current  column  number  (Integer,  Output) 

First  nonzero  row  in  columndnteger.  Output) 

Last  nonzero  row  in  column  (Integer,  Output) 

Number  of  nonzero  rows  in  column  (Integer,  Output) 

Column  density  (Real,  Output)  (DEN  is  a  decimal  fraction,  e.g.,  40%=.40) 
Number  of  strings  in  column  (Integer,  Output) 


Method: 


Design  Requirements: 

1.  Note  that  for  very  large  matrices,  DEN  is  a  single-precision  number  and  may  be  numerically  zero 
even  if  there  are  nonzero  terms  in  the  matrix. 

Error  Conditions: 
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Database  Matrix  Utility  Module:  MXUNP 

Entry  Point:  MXUNP 

Purpose: 

Tb  unpack  all,  or  a  portion,  of  a  matrix  column  and  then  to  move  to  the  next  column. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MXONP  (  MATNAM, 

MATNAM 
ARRAY 
ROWl 
NROW 


array,  ROWl,  NROW  ) 

Name  of  the  matrix  (Character,  Input) 

Array  containing  data  to  be  unpacked  (Any  t5^e.  Output) 
First  row  position  in  column  (Integer,  Input) 

Number  of  rows  to  unpack  (Integer,  Input) 


Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 


None 


Database  Matrix  Utility  Module:  MXUPT 

Entry  Point:  MXUPT 

Pimjose: 

To  unpack  a  column  of  a  matrix  one  term  at  a  time. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MXUPT  (  UNITID,  VAL,  IROW  ) 

UNITID  Unit  identification  fi'om  MXUPTI  call  (Integer,  Input) 

VAL  The  value  of  the  term  (Any  type,  Output) 

IROW  The  row  position  of  the  term  (Integer,  Output) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  Matrix  Utility  Module:  MXUPTF 
Entry  Point:  MXUPTF 


Purpose: 

lb  terminate  the  termwise  or  partial  unpacking  of  a  matrix  column. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 
r&T.T.  MXUPTF  (  MATNAM  ) 

MATHAM  Name  of  the  matrix  being  unpacked  (Character,  Input) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  Matrix  Utility  Module:  MXUPTI 


Point: 


MXUPTI 


To  initialize  a  matrix  column  for  term-by-term  or  partial  impacking. 
MAPOL  Calling  Sequence: 


Application  Calling  Sequence: 


CALL  MXUPTI  (  MATMAM,  UNITID  ) 


MATMAM 


UNITID 


Name  of  the  matrix  (Character,  Input) 
Unit  identifier  (Integer,  Output) 


Method: 

None 

Design  Requirements: 

1.  A  matrix  may  be  unpacked  by  columns  using  MXUNP,  by  term,  or  by  partial  colxxmns,  using  MXUPT 
and  MXUPTM,  but  not  by  any  combination. 

Error  Conditions: 


396 


Database  Matrix  Utility  Module:  MXUPTM 
Entry  Point:  MXUPTM 


To  unpack  partial  coliimns  of  a  matrix. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  MXUPTM  (  UNITID,  VALARR,  ROWl,  NROW  ) 


UNITID 

VALARR 

ROWl 


Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 


Unit  identifier  from  MXOTTI  call  (Integer,  Input) 

Array  that  will  contain  the  unpacked  rows  (Any  type,  Output) 
Initial  row  position  being  \mpacked  (Integer,  Output) 

Number  of  rows  being  unpacked  (Integer,  Output) 
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8.5.  UTILITIES  FOR  RELATIONAL  ENTITIES 


Relational  database  entities  are  used  to  save  highly  structiored  data  that  will  be  accessed  and 
modified  in  a  random  manner.  Utilities  to  operate  on  relations  are  summarized  below: 


SUBROUTINE 

FUNCTION 

RESCHM 

Defines  the  schema  of  a  relation 

REPROJ 

Defines  the  projection  of  the  relation  prior  to  I/O  activity 

REQURY 

Queries  the  schema  of  a  relation 

REGET 

Gets,  or  fetches,  a  qualified  entry  from  a  relation 

REGETM 

REUPD 

Updates  the  current  entry  of  a  relation 

REUPDM 

READD 

Adds  a  new  entry  to  a  relation 

READDM 

REPOS 

Positions  a  relation  to  an  entry 

RECPOS 

Checks  for  existence  of  a  given  entry 

RECOND 

Defines  constraints  or  WHERE  conditions  for  the  relation 

RESETC 

REENDC 

RENULD 

Checks  if  an  attribute  has  a  mdll  value 

RENULI 

RENULR 

RENUDS 

RECLRC 

Clears  conditions  defined  for  a  relation 

REGB 

Gets,  or  fetches,  all  of  the  qualified  entries  from  a  relation 

REGBM 

REAB 

Adds  a  group  of  entries  to  a  relation 

REABM 

RESORT 

Sorts  the  entries  of  a  relation 

8.5.1 .  Examples  of  Relational  Entity  Utilities. 

This  subsection  provides  specific  examples  of  operating  with  relations.  Particular  attention 
should  be  given  the  use  of  double-precision  data  attributes.  Special  routines  are  provided  for  such 
attributes  when  used  by  themselves  or  when  "mixed"  with  other  data  types. 
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8.5.2.  Creating  a  Relation. 


A  relational  entity  has  both  a  name  and  a  schema.  The  schema  defines  the  attributes  of  a  relation 
and  their  data  types.  Therefore,  a  call  to  the  RESCHM  routine  is  required  in  addition  to  a  dbcrea  call  m 
order  to  complete  the  creation  of  a  relational  entity.  For  example,  to  create  relation  GRID  (shown  m  the 
introduction  to  Section  8),  the  following  code  is  required: 


c 

c  DEFINE  ATTRIBUTES  TYPES,  AND  LENGTHS 

C 

CHARACTER  *8  GATTR  (4) 

CHARACTER  *8  GTYPE  (4) 

INTEGER  GLEN  ( 4 ) 

DATA  GATTR  /  'GID' ,  'X',  'Y' ,  'Z'/ 

DATA  GTYPE  /  'KINT',  'RSP' ,  'RSP' , 'RSP'  / 
DATA  GLEN  /  0,0, 0,0  / 

C 

C  CREATE  A  RELATION  AND  SCHEMA 
C 

CALL  DBCREA  (  'GRID'  ,  'REL') 

CALL  RESCHM  ('GRID',  4,  GATTR,  GTYPE,  GLEN  ) 


The  schema  is  specified  by  attribute  name  and  data  type.  Various  data  tj^es  are  available.  In  the 
example,  the  grid  ID,  GID,  is  called  a  keyed  integer  (kint).  This  causes  an  index  structure  to  be  created 
that  will  allow  fast  direct  access  to  a  given  entry.  The  coordinate  values  X,  Y,  and  Z  are  defined  as  real, 
single-precision  (RSP).  The  length  parameters  (GLEN)  are  only  used  for  character  attributes  and  for  arrays 
of  integers  or  real  numbers.  An  array  of  values  would  be  used  if  the  overall  data  organization  is  relational 
but  some  groups  of  values  are  only  used  on  an  all-or-nothing  basis. 


8.5.3.  Loading  Relational  Data. 

Once  a  relation  has  been  created  it  may  be  loaded  with  data.  There  are  two  modes  of  adding  data, 
one  entry  at  a  time,  or  a  "blast"  add  wherein  the  entire  relation,  or  a  large  part  of  it,  has  been  accumu¬ 
lated  in  memory.  For  each  mode,  there  are  two  options,  one  when  none  of  the  attributes  are  real, 
double-precision,  and  a  second  if  one  or  more  attributes  are  real,  double-precision.  Using  the  relation 
the  example  below  indicates  how  it  could  be  loaded  on  an  entiy-by-entry  basis. 
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c 

C  ALLOCATE  BUFFER  AREA  FOR  ENTRIES  AND  INFO 

C 

INTEGER  IBUF  (4),  INFO  (20) 

C 

C  USE  EQUIVALENCES  TO  HANDLE  REAL  DATA 

C 

EQUIVALENCE  (IGID,  IBUF  (1)),  (X,  IBUF  (2)  ) 

EQUIVALENCE  (y,  IBUF  (3)),  (Z,  IBUF  (4)  ) 

C 

C  DEFINE  THE  PROJECTION  AS  THE  FULL  RELATION 

C 

CHARACTER  *8  PATTR  (4) 

DATA  PATTR  /  'GID' ,  'X',  'Y',  'Z'/ 

C 

C  OPEN  THE  ENTITY  FOR  I/O 

C 

CALL  DBOPEN  ('GRID',  INFO,  'R/W',  'FLUSH',  ISTAT) 
CALL  REPROJ  ('GRID',  4,  PATTR) 

C 

C  READ  AN  ENTRY  FROM  INPUT,  ADD  TO  RELATION 

C 

DO  100  1=1,  lEND 

READ  (5,  101)  IGID,  X,Y,Z 
CALL  READD  {'GRID',  IBUF) 

100  CONTINUE 

C 

c 

c 

_ CALL  DBCLOS  ('GRID') _ 


Space  must  first  be  allocated  to  contain  an  entire  entry  of  the  relation.  This  buffer  must  be  of  a 
specific  type  so  that  equivalences  must  be  used  if  the  attributes  are  of  mixed  data  types.  The  projection  of 
the  relation  must  be  defined  (via  REPROJ)  even  if  all  attributes  are  being  selected.  If  the  data  had  been 
stored  in  memory  first,  the  REAB  routine  could  have  been  used  to  "blast"  all  of  the  entries  into  the 
relation  with  a  single  call. 

8.5.4.  Accessing  a  Relation 


A  relation  is  accessed  by  a  set  of  foxir  routines:  REGET,  REGETM,  REGB,  and  REGBM.  Several  other 
routines  now  come  into  play.  The  first  are  REPOS  and  RECPOS.  These  routines  are  used  to  find  an  entry 
within  a  relation  whose  key  is  equal  to  a  specific  value.  The  second  is  the  group  of  routines  recond, 
RESETC,  REENDC,  and  RECLRC.  These  allow  the  specification  of  more  complex  "where"  clauses  that  are 
used  to  qualify  an  entry  of  the  relation. 
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As  an  example,  suppose  that  the  X,  Y,  and  Z  coordinates  are  to  be  retrieved  for  a  grid  point  whose 
6ID  is  1.  The  code  segment  below  could  be  used  to  perform  this. 


c 

c  ALLOCATE  BUFFER  -  ALL  OUTPUT  IS  REAL 

C 

DIMENSION  COORDS  (3),  INFO  (20) 

C 

c  DEFINE  THE  PROJECTION 

C 

CHARACTER  *8  PATTR  (3) 

DATA  PATTR  /  'X',  'Y',  'Z'/ 

C 

C  OPEN  THE  ENTITY  FOR  I/O 

C 

CALL  DBOPEN  ('GRID',  INFO,  'R/W' ,  'NOFLUSH',  ISTAT) 
CALL  REPROJ  {'GRID',  3,  PATTR) 

C 

c  POSITION  TO  THE  DESIRED  ENTRY 

C 

CALL  REPOS  ('GRID',  'GID' ,  1) 

C 

C  GET  THE  ENTRY 

C 

CALL  REGET  ('GRID',  COORDS,  ISTAT) _ 


Note  that  GID  must  be  a  keyed  attribute  to  use  REPOS. 

To  qualify  an  entry  by  more  than  one  attribute,  a  sequence  of  an  RECOND  call,  any  number  of 
RESETC  calls,  and  an  reendc  call  can  be  used.  For  instance,  to  find  any  or  all  grid  points  whose 
coordinates  are  X=l,  Y=2,  Z=3,  the  code  segment  below  could  be  used: 


CALL 

RECOND  ('GRID' 

' EQ ' ,  1.0) 

CALL 

RESETC  {'AND', 

' EQ ' ,  2.0) 

CALL 

RESETC  ('AND', 

'Z'  , 

' EQ ' ,  3.0) 

CALL 

REENDC 

CALL 

REGET  {'GRID', 

BUF, 

ISTAT) 

Each  call  to  REGET  will  retrieve  an  entry  that  satisfies  the  specified  conditions.  An  ISTAT  value 
greater  than  zero  indicates  the  end  of  successful  retrievals.  Conditions  may  include  any  of  the  relational 
operators,  the  MAX  and  MIN  selectors  and  the  Boolean  operators  AND  and  OR.  If  one  of  either  MIN  or  MAX 
issued,  however,  it  is  the  only  condition  allowed.  To  reset  a  new  set  of  conditions  on  an  open  relational 
entity,  the  utility  RECLRC  may  be  called  to  destroy  the  current  conditions. 

8.5.5.  Updating  a  Relational  entry. 

One  of  the  most  powerful  features  of  the  relational  database  is  the  ability  to  randomly  modify  a 
small  number  of  data  items  efficiently.  To  do  this,  the  utihties  redupd  and  redupm  are  used.  The  update 
procedure  is  a  simple  one.  First,  the  projection  is  set.  This  is  followed  by  positioning  to  a  row  or  rows  by 
specifying  a  repos,  recpos  or  an  recond.  Routine  reget  is  then  used  to  fetch  the  entry.  One  or  more  of 
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attributes  may  then  be  modified  in  the  buffer  and  an  REDUP  used  to  accomplish  the  update.  Note  that 
attributes  not  in  the  projection,  and  attributes  not  modified  in  the  buffer,  will  remain  vmchanged. 

8.5.6.  Other  Operations. 

If  it  is  necessary  for  an  apphcation  to  determine  the  schema  of  a  given  relation,  this  may  be  done 
with  the  utility  requry.  This  routine  returns  the  names  and  types  of  each  attribute  in  the  schema. 
Finally,  a  relation  may  be  sorted  in  an  ascending  or  descending  manner  on  one  or  more  of  its  attributes 
by  using  the  utility  RESORT. 
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Database  Relational  Utility  Module;  REAB 
Entry  Point:  REAB 


Purpose: 

lb  add  multiple  entries,  held  in  memory,  to  a  specified  relation. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 


CALL  REAB 
RELNAM 
BXJF 
INDM 


RELNAM,  BPF,  XNUM  ) 

Name  of  the  relation  (Character,  Input) 

Array  that  contains  the  entries  to  be  added  to  the  relation  (Any,  Input) 
The  number  of  entries  to  be  added  (Integer,  Input) 


Method: 

None 

Design  Requirements: 

1.  Only  integer,  real  single-precision,  or  string  attributes  may  be  added  with  this  routine. 

Error  Conditions: 

None 
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Database  Relational  Utility  Module:  REABM 

Entry  Point:  REABM 

Purpose: 

Tb  add  multiple  entries,  held  in  memory,  to  a  specified  relation  where  the  relational  attributes  are 
double-precision,  or  mixed  precision,  types. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  REABM  (  RELNAM,  SM6L,  DBLE,  IMUM  ) 

RELNAM  Name  of  the  relation  (Character,  Input) 

SNGL  Array  that  contains  the  single-precision  (Integer,  Real,  Single-Precision, 

or  String)  attributes  to  be  added  (Any,  Input) 

DBLE  Array  that  contains  the  double-precision  attributes  to  be  added 

(Double,  Input) 

INUM  The  number  of  entries  to  be  added  (Integer,  Input) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  Relational  Utility  Module:  READD 
Entry  Point:  READD 


Purpose: 

To  add  a  new  entry  to  a  relation. 


MAPOL  Calling  Sequence: 


None 

Application  Calling  Sequence: 

CALL  READD  (  RELNAM, 
RELNAM 
BUF 


BUF  ) 

Name  of  the  relation  (Character,  Input) 

Array  that  contains  the  entries  to  be  added  to  the  relation  (Any,  Input) 


Method: 

None 

Design  Requirements: 

1.  Only  integer,  single-precision,  or  string  attributes  may  be  added  with  this  routine. 
Error  Conditions: 

None 
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Database  Relational  Utility  Module;  READDM 

Entry  Point:  READDM 

Purpose: 

To  add  a  new  entry  to  a  relation  that  contains  double-precision,  or  mixed  precision,  attributes. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  READMM  (  RELNAM,  SNGL,  DELE  ) 

RELNAM  Name  of  the  relation  (Character,  Input) 

SNGL  Array  that  contains  the  single-precision  entry  data  (Any,  Input) 

dble  Array  that  contains  the  double-precision  entry  data  (Double,  Input) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  Relational  Utility  Module:  RECLRC 
Entry  Point:  RECLRC 


Purpose: 

Tb  clear  the  conditions  set  on  a  relational  entily  without  performing  a  DBCLOS. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  RECLRC  (  ENTNAM  ) 

entnam  The  name  of  the  relational  entity  (Character,  Input) 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  Relational  Utility  Module:  recond 
Entry  Point:  RECOND 


To  define  a  condition,  or  constraint,  for  a  relational  attribute  prior  to  performing  a  get  operation  (see 
also  RESETC). 

MAPOL  Calling  Sequence: 


Application  Calling  Sequence: 


CALL  RECOND  (  RELNAM,  ATTRNAN,  RELOP,  VAL  ) 


RELNAM 


ATTRNAM 


RELOP 


Name  of  the  relation  (Character,  Input) 

Name  of  the  attribute  (Character,  Input) 

The  relational  operator  for  the  constraint;  one  of  '  EQ ' ,  '  NE ' ,  '  gt  ' , 
'LT',  'GE',  'LE',  'MAX',  'MIN'  (Character,  Input) 

The  value  to  be  tested  (Any,  Input) 


Method: 


Design  Requirements: 

1.  VAL  must  be  the  same  type  as  the  ATTRNAM.  All  RELOPs  are  legal  for  attributes  of  type  'INT', 
'KINT',  'RSP',  and  'RDP'.Only  'EQ'  and  'NE'  are  valid  for  attribute  types  'STR'  and  'KSTR'. 
Attribute  types  of 'AINT',  'ARSP',and  'ARDP'  maynotbeusedinacondition.  Also,  for  attributes 
of  type  'STR'  or  'KSTR',  their  length  must  be  8  or  fewer  characters.  Note  that  string  attribute 
values  are  passed  as  hollerith  data. 

2.  Any  RECOND  call  removes  any  existing  conditions,  that  is,  it  performs  an  RECLRC  internally. 

Error  Conditions: 
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Database  Relational  Utility  Module;  RECPOS 

Entry  Point:  RECPOS 

Pvirpose: 

lb  position  to  a  specific  entry  and  return  the  row  number,  if  present. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  RECPOS  (  RELNAM,  KEY,  VAL,  ROWNOM  ) 

Name  of  the  relation  (Character,  Input) 

Name  of  a  keyed  attribute  (Character,  Input) 

The  desired  value  of  the  keyed  attribute  (Integer,  Input) 

The  row  number  satisfying  the  condition.  If  zero,  no  entries  were  found 
(Integer,  Output) 

Method: 

None 

Design  Requirements: 

1.  If  the  KEY  is  a  character  attribute,  it  must  be  of  length  eight  and  val  must  contain  the  hollerith 
representation  of  the  desired  value.  The  conversion  from  character  to  hollerith  must  be  made  with 
the  DBMDCH  routine. 

Error  Conditions: 


RELNAM 

KEY 

VAL 

ROVIMUM 


None 


Database  Relational  Utility  Module: 

Entry  Point:  REENDC 

Purpose: 

lb  end  the  definition  for  a  relational  entity. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  REENDC 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 


REENDC 
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Database  Relational  Utility  Module:  regb 
Entry  Point:  REGB 


Purpose: 

Tb  fetch  all  of  the  entries  of  the  requested  relation  that  satisfy  the  specified  projection  and  constraints 
(see  also  RE6BM). 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  REGB  (  RELNAM,  BUF,  INUM,  ISTAT  ) 

Name  of  the  relation  (Character,  Input) 

Array  that  will  contain  the  entries  (Any,  Output) 

The  number  of  entries  fetched  (Integer,  Output) 

Status  return  (Integer,  Output) 

0  entries  successfully  fetched 

201  no  entries  found 

Method: 

None 

Design  Requirements: 

1.  Only  integer  or  real,  single-precision  or  string  attributes  may  be  fetched  with  this  routine. 

Error  Conditions: 

None 


RELNAM 

BUF 

INUM 

ISTAT 
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Database  Relational  Utility  Module:  REGBM 

Entry  Point:  REGBM 

Piirpose: 

lb  fetch  all  of  the  entries  of  the  requested  relation  that  satisfy  the  specified  projection  and  constraints 
and  that  contain  double-precision,  or  mixed  precision  attributes. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  REGBM  (  RELNAM,  SNGL,  DBLE,  INUM^  ISTAT  ) 

RELNAM  Name  of  the  relation  (Character,  Input) 

SNGL  Array  that  will  contain  single-precision  entry  data  (Integer,  Real  Single- 

precision,  or  String,  Output) 

DBLE  Array  that  will  contain  double-precision  entry  data  (Double,  Output) 

INUM  The  number  of  entries  fetched  (Integer,  Output) 

ISTAT  Status  return  (Integer,  Output) 

0  entries  successfully  fetched 

201  no  entries  foimd 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  Relational  Utility  Module:  REGET 

Entry  Point:  REGET 

Purpose: 

Tb  fetch  an  entry  of  a  relation  that  satisfies  the  given  projection  and  constraint  conditions. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

rax.T.  reget  {  RELNAM,  EOT,  ISTAT  ) 

Name  of  the  relation  (Character,  Input) 

Array  that  will  contain  the  entry  data  (Any,  Output) 

Status  return  (Integer,  Output) 

0  entries  successfully  fetched 

201  no  entries  found 


None 


RELNAM 

BUF 

ISTAT 

Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
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Database  Relational  Utility  Module;  regetm 

Entry  Point:  REGETM 

Purpose: 

To  fetch  an  entry  of  a  relation  that  satisfies  the  given  projection  and  constraint  conditions,  and  that 
contains  double-precision,  or  mixed  precision  attributes. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  REGETM  (  RELNAM,  SNGL^  DELE,  ISTAT  ) 

RELNAM  Name  of  the  relation  (Character,  Input) 

SNGL  Array  that  will  contain  single-precision  entry  data  (Integer,  Real  Single¬ 

precision,  or  String)  (Any,  Output) 

dele  Array  that  will  contain  double-precision  entry  data  (Double,  Output) 

ISTAT  Status  return  (Integer,  Output) 

0  entries  successfully  fetched 

201  no  entries  found 

Method: 

None 

Design  Requirements: 

None 

Error  Conditions: 

None 


414 


Database  Relational  Utility  Module:  RENULx 
Entry  Points:  RENULD,  RENULI,  RENULR,  RENULS 


Purpose: 

lb  check  if  a  double-precision,  integer,  real,  or  character  attribute  has  a  null  value.  Attributes  excluded 
from  the  projection  when  a  relational  entry  is  added  are  given  such  null  values. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequences: 

RENULD  (  FIELDD  ) 

RENULX  (  FIELD!  ) 

RENULR  (  FXELDR  ) 

RENULS  (  FXELDS  ) 


FXELDD 

Double  precision  attribute  value  (Input) 

FXELDX 

Integer  attribute  value  (Input) 

FXELDR 

Real,  single-precision  attribute  value  (Input) 

FXELDS 

String  attribute  value  (Input) 

RENULD 

RENULX 

RENULR 

RENULS 

Logical  values  (output)  TRUE  if  FIELDx  is  null 

Method: 

None 

Design  Requirements: 

1.  The  string  attribute,  FXELDS,  must  be  passed  as  a  hollerith. 

Error  Conditions: 


None 


Database  Relational  Utility  Module:  REPOS 


Entry  Point:  REPOS 


Purpose: 

Tb  position  a  relation  to  an  entry  with  a  given  keyed  attribute. 
MAPOL  Calling  Sequence: 

None 


Application  Calling  Sequence: 

CALL  REPOS  (  RELNAM,  KEY,  VAL  ) 

RELN2UI  Name  of  the  relation  (Character,  Input) 

KEY 


VAL 


Name  of  a  keyed  attribute  (Character,  Input).  The  special  attribute  name 
of  'ENTRYNPH'  with  a  VAL=1  may  be  used  to  reposition  an  entity  to  the 
beginning. 

The  desired  value  of  the  keyed  attribute  (Integer,  Input) 


Method: 

None 

Design  Requirements: 

1.  The  attribute  must  be  keyed. 

2 .  If  KEY= '  ENTRYNOM '  then  VAL  must  be  1 . 

Error  Conditions: 

1.  A  database  fatal  error  occurs  if  the  requested  entry  does  not  exist. 
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Database  Relational  Utility  Module:  REPROJ 
Entry  Point:  REPROJ 


Purpose: 

To  define  the  projection,  or  subset  of  attributes,  for  the  relation  prior  to  performing  updates,  adds  or 
gets  of  entries. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 


CALL  REPROJ  (  RELllAll, 
RELNAM 
NATTR 
ATTRLIST 


NATTR,  ATTRLIST  ) 

Name  of  the  relation  (Character,  Input) 

Number  of  attributes  in  the  projection  (Integer,  Input) 

Array  containing  the  attribute  names  that  define  the  projection 
(Character,  Input) 


Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 
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Database  Relational  Utility  Module;  REQURY 

Entry  Point:  REQURY 

Purpose: 


To  retrieve  the  schema  of  a  relation. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  REQURY  (  RELNM,  NATTR,  ATTRLIST,  ATTRTYPE,  ATTRLEN,  TOTLEN  ) 


RELNAM 

NATTR 

ATTRLIST 

ATTRTYPE 


Name  of  the  relation  (Character,  Input) 

Number  of  attributes  (Integer,  Output) 

Array  containing  the  attribute  names  (Character,  Output) 
Array  containing  the  attribute  types  (Character,  Output) 


ATTRLEN 

TOTLEN 


'INT' 

Integer  attribute 

'KINT' 

Keyed  integer  attribute 

'AINT' 

Array  of  integers 

'RSP^ 

Real,  single-precision  attribute 

'ARSP' 

Array  of  single-precision 

'RDP' 

Real,  double-precision  attributes 

'ARDP' 

Array  of  double-precision 

'STR' 

String  attribute 

'KSTR' 

Keyed  string  attribute 

Array  defining  the  number  of  elements  in  an  array  attribute  or  the  num¬ 
ber  of  characters  in  a  string  attribute  (Integer,  Output) 

Total  length  of  schema  in  words  (Integer,  Output) 


Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 
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Database  Relational  Utility  Module:  RESCHM 
Entry  Point:  RESCHM 


Purpose: 

lb  define  the  schema  of  a  relation  being  created  by  a  functional  module. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

raT.T.  RESCHM  (  RELNAM,  NATTR,  ATTRLIST,  ATTRTYPE,  ATTRLEN  ) 

relmam  Name  of  the  relation  (Character,  Input) 

nrttr  Number  of  attributes  (Integer,  Input) 

ATTRLIST  Array  containing  the  attribute  names  (Character,  Input) 

ATTRTYPE  Array  containing  the  attribute  types  (Character,  Input) 


'INT' 

Integer  attribute 

'KINT' 

Keyed  integer  attribute 

'AINT' 

Array  of  integers 

'RSP' 

Real,  single-precision  attribute 

'ARSP' 

Array  of  single-precision 

'RDP' 

Real,  double-precision  attributes 

'ARDP' 

Array  of  double-precision 

'STR' 

String  attribute 

'KSTR' 

Keyed  string  attribute 

Array  defining  the  number  of  elements  in  an  array  attribute  or  the  num¬ 
ber  of  characters  in  a  string  attribute  (Integer,  Input) 


Method: 

None 

Design  Requirements: 

1.  The  relation  RELNAM  must  not  already  have  a  schema  defined. 

2 .  Keyed  attributes  must  have  uniform  values  for  all  rows . 

3.  No  attributes  may  have  the  name  'ENTRYNDM' 

4.  Attributes  of  the  type  '  kstr  '  must  have  length  of  8  or  fewer  characters. 
Error  Conditions: 

None 
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Database  Relational  Utility  Module:  resetc 
Entry  Point:  RESETC 


Purpose: 

Tb  define  additional  conditions,  or  constraints,  for  a  relational  attribute  prior  to  performing  a  get 
operation  (see  also  RECOND). 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  RESETC  (  BOOL,  ATTERNAM,  RELOP,  VAL  ) 

BOOL  The  boolean  operation  'OR'  or  'AND'  (Character,  Input) 

ATTRNAM  Name  of  the  attribute  (Character,  Input) 

BELOP  The  relational  operator  for  the  constraint;  one  of  '  EQ ' ,  '  NE ' ,  '  GT ' , 

'LT',  'GE',  'LE',  'MAX',  'MIN'  (Character,  Input) 

VAL  The  value  to  be  tested  (Any,  Input) 

Method: 

None 

Design  Requirements: 

1.  VAL  must  be  the  same  type  as  the  ATTRNAM.  A  maximum  of  10  conditions  may  be  specified.  All 
RELOPs  are  legal  for  attributes  of  type  'INT',  'KINT',  'RSP',  and  'RDP'.  Only  'EQ'  and  'NE' 
are  valid  for  attribute  t3^es  'STR'  and  'KSTR'.  Attribute  types  of  'AINT',  'ARSP',  and  'ARDP' 
may  not  be  used  in  a  condition.  Also,  for  attributes  of  type  '  STR'  or  'KSTR' ,  their  length  must  be 
8  or  fewer  characters.  Only  one  condition  may  have  a  'MAX'  or  'MIN'  RELOP.  Note  that  string 
attribute  values  are  passed  as  hollerith  data. 

Error  Conditions: 

None 
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Database  Relational  Utility  Module;  RESORT 
Entry  Point:  RESORT 


Purpose: 

To  sort  a  relation  on  one  or  more  of  its  attributes. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  RESORT  (  RELNAM,  NATTR,  SORTTYPE,  ATTRLIST,  KORE  ) 

Name  of  the  relation  (Character,  Input) 

The  ntimber  of  attributes  to  be  sorted  (Integer,  Input) 

The  type  of  sort  for  each  attribute  (Character,  Input) 

^ASC'  Ascending 

•  DES '  Descending 

A  list  of  the  attributes  to  be  sorted  (Character,  Input) 

Base  address  of  open  core  (Input) 

Method: 

None 

Design  Requirements: 

2,  The  sort  sequence  is  performed  in  the  order  that  the  attributes  are  specified  in  attrlist. 
2.  The  relation  RELNZ^  must  be  closed  when  RESORT  is  called. 

Error  Conditions: 

None 


RELNAM 

NATTR 

SORTYPE 

ATTRLIST 

KORE 
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Database  Relational  Utility  Module:  REUPD 

Entry  Point:  REUPD 

Purpose: 

lb  update  the  current  relational  entry. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  REUPD  (  RELNAM,  BUF  } 

RELNAM  Name  of  the  relation  (Character,  Input) 

BUF  Array  that  contains  updated  entry  data  (Any,  Input) 

Method: 

None 

Design  Requirements: 

1.  Only  integer,  single-precision  or  string  attributes  may  be  updated  with  this  routine. 
Error  Conditions: 

None 
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Database  Relational  Utility  Module:  reupdm 
Entry  Point:  REUPDM 


Purpose: 

Tb  update  the  current  relational  entry  that  contains  double-precision,  or  mixed  precision,  attributes. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  REUPDM  (  RELNAM,  SN6L,  DELE  ) 

Name  of  the  relation  (Character,  Input) 

Array  that  contains  the  single-precision  entry  data  (Any,  Input) 

Array  that  contains  the  double-precision  entry  data  (Double,  Input) 


RELNAM 

SMGL 

DBLE 


Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 
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8.6.  UTILITIES  FOR  UNSTRUCTURED  ENTITIES 

Unstructured  database  entities  are  used  primarily  for  scratch  I/O  by  modules  or  for  saving  data 
that  are  generally  used  on  an  all-or-nothing  basis.  That  is,  random  access  to  anything  other  than  a 
complete  record  is  not  used.  The  utiUties  to  support  this  type  of  data  are  shown  below: 


SUBROUTINE 

FUNCTION 

UNPOS 

Positions  to  a  given  unstructured  record 

UNRPOS 

UNSTAT 

Returns  the  length  of  a  record 

UNGET 

Gets,  or  fetches,  an  entire  record 

UNGETP 

Gets,  or  fetches,  a  partial  record 

UNPUT 

Adds  a  new  record  to  the  unstructured  entity 

UNPUTP 

Adds  a  partial  record  to  the  entity 

8.6.1 .  Generating  an  Unstructured  Entity 

As  seen  in  Subsection  8.2,  the  first  step  in  generating  any  entity  is  to  perform  a  DBCREA.  This  is 
followed  by  a  DBOFEN,  any  desired  I/O  activity,  and  finally  a  DBCLOS.  Suppose,  for  example,  the  local 
coordinates  X,  Y,  and  Z  of  1000  grid  points  have  been  computed  and  are  in  a  block  of  dynamic  memory 
called  GRID  whose  location  pointer  is  IGRD  (see  Section  8.3).  Further,  assume  that  these  coordinates  have 
also  been  converted  to  the  basic  coordinate  system,  and  that  these  transformed  coordinates  are  located  in 
block  KGRD  with  pointer  IGND.  These  data  will  be  used  in  a  subsequent  routine  or  module  in  their 
entirety.  It  will  therefore  be  written  into  an  unstructiured  entity  called  coord  in  two  distinct  records.  The 
code  segment  to  perform  this  is  shown  below: 

-  ^ 

C  CREATE  THE  NEW  ENTITY  AND  OPEN  FOR  I/O 

C 

CALL  DBCREA  ('COORD',  'lUN') 

CALL  DBOPEN  ('COORD',  INFO,  'R/W',  'FLUSH',  ISTAT) 

C 

C  WRITE  THE  TWO  UNSTRUCTURED  RECORDS 

C 

CALL  UNPUT  ('COORD',  Z  (IGRD),  3000) 

CALL  UNPUT  ('COORD',  Z  (IGND) ,  3000) 

C 

C  I/O  COMPLETE  CLOSE  ENTITY 

C 

_ CALL  DBCLOS  ('COORD') _ 


The  DNPUT  call  loads  a  complete  record  into  the  entity.  Therefore,  the  above  operations  generate 
two  records  in  COORD.  If  an  operation  is  being  performed  "on-the-fly,"  or  complete  records  do  not  fit  in 
memory,  then  a  "partial"  put,  xjnputp,  may  be  performed. 
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Now  assume  that  the  local  coordinates  are  all  in  memory,  but  that  the  transferred  coordinates 
will  be  generated  on  a  point-by-point  basis  and  written  to  the  COORD  entity.  Subroutine  transf  trans¬ 
forms  a  set  of  three  local  coordinates  to  basic  coordinates  stored  in  a  local  array  XNEW.  This  is  illustrated 

below; 

CREATE  AND  OPEN  THE  ENTITY 
CALL  DBCREA  ('COORD',  'UN') 

CALL  DBOPEN  ('COORD',  INFO,  'R/W' ,  'FLUSH',  ISTAT) 

FIRST  WRITE  THE  LOCAL  COORDINATE 

CALL  UNPUT  ('COORD',  Z  (IGRD) ,  3000) 

NEXT,  COMPUTE  NEW  COORDINATES  ONE-AT-A-TIME 

DO  100  1=0,2999,3 

CALL  TRANSF  (Z  (IGRD+I) ,  XNEW) 

CALL  UNPUTP  ('COORD',  XNEW,  3) 

CONTINUE 

TERMINATE  PARTIAL  RECORD  AND  CLOSE 
CALL  UNPUT  ('COORD',  0,0) 

CALL  DBCLOS  ('COORD') _ _ _ _ _ 

Note  that  a  record  of  an  unstructured  entity  that  is  created  by  partial  puts  must  be  "closed"  by  a 
call  to  UNPUT.  In  this  case,  the  final  put  operation  does  not  extend  the  record  but  only  terminates  it. 

8.6.2.  Accessing  an  Unstructured  Entity. 

The  UNPUT  and  UNPUTP  utilities  have  direct  analogs  in  UNGET  and  UNGETP  for  the  retrieval  of 
data.  Three  other  utilities  are  available  for  data  access.  The  first  two,  unpos  and  unrpos,  allow  an 
unstructured  entity  to  be  positioned  to  a  specific  record.  Note  that  this  access  is  much  faster  if  the  entity 
was  created  with  an  index  structure,  that  is,  the  DBCREA  call  specified  type  'lUN'.  The  third  utility, 
UNSTAT,  is  used  to  find  length  of  a  given  record.  These  utihties  are  demonstrated  in  the  example  below, 
the  second  record  of  coord  will  be  accessed  and  each  coordinate  set  used  individually.  It  is  not  assumed 
that  the  number  of  grid  points  is  known  to  this  application. 


c 

C  OPEN  THE  ENTITY,  READONLY  MODE 

C 

CALL  DBOPEN  ('COORD',  INFO,  'RO',  'NOFLUSH',  ISTAT) 
C 

C  NOFLUSH  PROTECTS  AGAINST  DESTROYING  THE  DATA, 

C  NOW,  POSITION  TO  RECORD  2,  GET  LENGTH  OF  RECORD 

C 

CALL  UNPOS  ( ' COORD ' ,  2 ) 

CALL  UNSTAT  ('COORD',  IREC,  LEN) 

C 

C  LEN  IS  THE  NUMBER  OF  WORDS  IN  THE  RECORD, 

C  FETCH  AND  USE  COORDINATES  ONE-AT-A-TIME 

C 

NGRID=LEN/3 
DO  100  1=1,  NGRID 

CALL  UNGETP  ('COORD',  XNEW,  3) 

C 

C  USE  THE  XNEW  VALUES  HERE 

C 

100  CONTINUE 

C 

C  I/O  COMPLETE,  CLOSE  THE  ENTITY 

C 

_ CALL  DBCLOS  ('COORD') _ 


8.6.3.  Modifying  an  Unstructured  Entity. 

It  is  also  possible  to  modify,  or  update,  the  contents  of  an  individual  record  within  an  unstruc¬ 
tured  entity.  The  only  limitation  to  this  feature  is  that  the  length  of  the  record  must  be  the  same  as,  or 
less  than,  the  length  of  the  originally  created  record. 
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Database  Unstructured  Utility  Module:  UNGET 
Entry  Point:  UNGET 


Purpose: 

lb  fetch  a  complete  record  from  an  unstructured  entity. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  UNGET  (  NAME,  ARAY,  NWORD  ) 

Name  of  the  imstructured  entity  (Character,  Input) 

Array  that  will  contain  the  unstructured  record  (Integer,  Output) 

The  number  of  single-precision  words  to  be  transferred  (Integer,  Input) 

Method: 

If  NWORD  is  less  than  the  total  number  of  words,  the  remaining  data  will  not  be  retrieved.  TDIGET  positions 
the  entity  to  the  next  record  after  the  retrieval. 

Design  Requirements: 

None 

Error  Conditions: 

None 


NAME 

ARAY 

NWORD 
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Database  Unstructured  Utility  Module:  UNGETP 
Entry  Point:  UNGETP 


Purpose: 

To  fetch  a  portion  of  an  unstructured  record. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  UNGETP  (  NAME,  AKAY,  NWORD  ) 

NAME  Name  of  the  unstructured  entity  (Character,  Input) 

ARAY  Array  that  will  contain  the  unstructured  record  (Integer,  Output) 

NWORD  The  number  of  single-precision  words  to  be  transferred  (Integer,  Input) 

Method: 

Following  the  retrieval,  the  entity  is  still  positioned  at  the  same  record,  a  subsequent  UNGET  or  UNGETP 
will  get  the  next  words  in  the  record. 

Design  Requirements: 

None 

Error  Conditions: 

None 
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Database  Unstructured  Utility  Module:  UNPOS 
Entry  Point:  UNPOS 


Tb  position  an  unstructtu-ed  entity  to  a  specific  record. 

MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  UNPOS  (  NAME,  RECNO  ) 

NAME  Name  of  the  unstructured  entity  (Character,  Input) 


RECNO 


Record  number  (Integer,  Input) 


Method: 


Design  Requirements: 


Error  Conditions: 
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Database  Unstructured  Utility  Module:  UNPUT 

Entry  Point:  UNPUT 

Purpose: 

Ib  add  a  record  to  an  unstructured  entity.  The  record  is  terminated  after  the  transfer. 
MAPOL  Calling  Sequence: 

None 

Apphcation  Calling  Sequence: 

CALL  UNPUT  (  NAME/  ARAY/  NWORD  ) 


NAME 

ARAY 

NWORD 

Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 


Name  of  the  unstructured  entity  (Character,  Input) 
Array  containing  the  record  to  be  added  (Any,  Input) 
The  number  of  words  to  be  transferred  (Integer,  Input) 
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Database  Unstructured  Utility  Module:  UNPUTP 

Entry  Point:  UNPUTP 

Purpose: 

lb  add  a  partial  record  to  an  unstructured  entity.  The  record  is  not  terminated  after  the  transfer. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 


CALL  UNPUTP  (  NAME, 
NAME 
AHAY 
NWORU 


ARAY,  NWORD  ) 

Name  of  the  unstructured  entity  (Character,  Input) 
Array  containing  the  record  to  be  added  (Any,  Input) 
The  number  of  words  to  be  transferred  (Integer,  Input) 


Method: 

None 

Design  Requirements: 
None 

Error  Conditions : 


None 


Database  Unstructured  Utility  Module;  unrpos 
Entry  Point:  UNRPOS 


Purpose: 

lb  position  an  unstructured  entity  to  a  specific  record  defined  as  an  increment  from  the  current  record. 
MAPOL  Calling  Sequence: 

None 

Application  Calling  Sequence: 

CALL  DNSTAT  {  NAME,  DELRID  ) 

name  Name  of  the  unstructured  entity  (Character,  Input) 

DELRID  Record  number  increment  relative  to  the  current  position  (Integer,  Input) 


Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 
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Database  Unstructxired  Utility  Module :  UNSTAT 

Entry  Point:  UNSTAT 


Purpose: 

Tb  return  the  length,  in  single-precision  words,  of  the  ciirrent  record. 


MAPOL  Calling  Sequence: 
None 

Application  Calling  Sequence: 
CALL  UNSTAT  (  NAME, 
NAME 
BECNO 
LEN 


RECNO,  LEN  ) 

Name  of  the  unstructured  entity  (Character,  Input) 
Current  record  ntunber  (Integer,  Output) 

Record  length  in  single-precision  words  (Integer,  Output) 


Method: 

None 

Design  Requirements: 
None 

Error  Conditions: 
None 
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9.  DATABASE  ENTITY  DESCRIPTIONS 


All  intermodular  communication  in  ASTROS  is  done  through  data  stored  on  the  CADDB  database. 
As  a  result,  there  are  many  relations,  matrices,  and  unstructured  entities  that  are  defined  to  store  the  data 
requisite  to  the  analyses.  This  section  provides  a  description  of  each  of  the  database  entities  that  are  used 
in  the  ASTROS  system.  These  data  are  useful  both  to  the  ASTROS  programmer,  who  needs  to  know  the 
description  of  each  of  the  entities  to  interpret  and  modify  the  ASTROS  source  code,  and  to  the  general  user 
in  that  these  data  are  available  on  the  database  for  other  uses  such  as  the  Interactive  CADDB  Environment, 
ICE.  For  supplementary  post-processing,  the  matrix  entities  may  be  combined  using  the  MAPOL  language 
to  generate  data  not  otherwise  computed.  At  a  more  sophisticated  level,  a  user-written  Fortran  module  may 
take  p-gisting  data  from  the  entities  to  perform  more  advanced  operations  that  are  beyond  the  capabilities 
of  the  ASTROS  executive  system. 

The  entities  are  documented  in  alphabetical  order  and  every  entity  which  is  used  in  intermodule 
communication  is  included.  Those  entities  which  are  used  for  scratch  storage  within  a  module  are 
documented  in-line  rather  than  in  the  Programmer’s  Manual.  The  entities  presented  here  fall  into  three 
categories:  system  level,  hidden  entities,  and  MAPOL  entities.  The  first  include  those  entities  that 
communicate  system  information  between  modules.  The  hidden  and  MAPOL  entities  are  those  which  are 
declared  in  the  MAPOL  sequence  itself.  The  hidden  entities  do  not  subsequently  appear  in  the  MAPOL 
sequence;  their  declaration  is  included  as  a  convenience  to  the  ASTROS  executive  system.  The  most  common 
example  of  a  hidden  entity  is  any  relation  associated  with  a  Bulk  Data  entry.  These  relations  are  used 
internally  by  numerous  modules  but  they  do  not  appear  in  the  MAPOL  calling  sequences  because  their 
inclusion  would  resialt  in  an  unpractically  large  number  of  arguments.  MAPOL  entities  are  the  most  relevant 
and  include  most  matrix  entities  and  a  large  number  of  relational  entities  that  are  used  to  pass  data  between 
engineering  modules. 

The  entity  documentation  format  is  slightly  different  for  each  of  the  entity  classes.  The  core 
information,  however,  is  the  same  for  each  class  and  includes  the  entity  name,  a  description  of  its  contents, 
the  modules  that  create  or  add  data  to  the  entity,  and  any  additional  notes  required  to  define  special  data 
tiandling  functions.  Each  entity  class  then  has  an  additional  set  of  information. 

Matrix  entities  have  a  section  labeled  Matrix  Form  which  gives  the  row  and  column  dimensions  of 
the  matrix  and  indicates  the  numeric  precision  and  the  form  of  the  entity.  Relational  entities  have  a  section 
called  Relation  Attributes  which  fists  the  schema  of  the  relation  and  defines  the  meaning  of  each  of  the 
attributes.  Finally,  unstructured  entities  have  have  a  section  labeled  Entity  Structure  which  fists  and  defines 
the  number  and  contents  of  the  records  of  the  entity. 
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Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  lype: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


AA 

Matrix 

Acceleration  in  the  a-set  merged  from  the  AL  and  AR  matrices  (see  AG). 

AAICMAT 

Subscripted  Matrix 

Aerodynamic  influence  coefficient  matrix  for  an  antisymmetric  bmmdary  condition 

and  a  given  Mach  number.  The  Mach  number  associated  with  a  given  subscript  is 

given  in  the  TRIM  relation. 

Square,  real  and  asymmetric.  The  dimension  of  the  matrix  is  equal  to  the  munber 

of  panels  in  the  steady  aerodynamics  USSAERO  model. 

Module  STEADY 

1.  STEADY  creates  as  many  matrices  as  there  are  distinct  antisymmetric  Mach 
ntunbers  in  the  user’s  input  packet.  If  a  combination  of  symmetric  and  anti¬ 
symmetric  Mach  numbers  are  used,  the  MINDEX  changes  for  each  distinct 
Mach  number.  An  AAICMAT  entity  is  created  for  a  given  MINDEX  only  if 
the  corresponding  Mach  number  requires  the  antisjmmetric  boundary  condi¬ 
tions.  It  is  possible,  therefore,  that,  in  the  range  from  1  to  MINDEX,  some 
subscript  values  will  not  have  a  corresponding  AAICMAT. 
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Entity: 

Entity  Type: 
Description: 

Entity  Structure: 


ACPT 

Unstructured 

Contains  one  record  for  each  independent  group  of  aerodynamic  elements  with  data 
needed  to  generate  the  aerodynamic  matrices. 


RECORD 

WORD 

TYPE 

ITEM 

1 

I 

Key  word,  1  for  doublet  lattice 

2 

I 

Number  of  panels,  NP 

3 

I 

Number  of  strips,  NSTRIP 

4 

I 

Number  of  boxes,  NTP 

5 

R 

F,  fraction  of  box  chord  from  center  of 
pressure  to  downwash  center 

1 

NP  WORDS 

I 

NCARAY,  boxes  per  chord 

NP  WORDS 

I 

NBARAY,  last  box  on  panel 

NSTRIP 

WORDS 

R 

YS  aero  coordinates  of  strip 

NSTRIP 

WORDS 

R 

ZS  center 

NSTRIP 

WORDS 

R 

EE  strip  half  width 

— 

NSTRIP 

WORDS 

R 

SG  sine  of  dihedral  angle 

NSTRIP 

WORDS 

R 

CG  cosine  of  dihedral  angle 

NTP  WORDS 

R 

XIC  coordinate  of  center  of  pressure 

NTP  WORDS 

R 

DELX  box  chord 

NTP  WORDS 

R 

XLAM  tangent  of  sweepback  angle  1 

NTP  WORDS 

R 

TR  box  taper  ratios  I 

2 

1 

I 

Key  word,  2  for  Doublet  Lattice  with 

Bodies  1 

2 

I 

NJ,  Number  of  J  points  I 

3 

I 

NK,  Number  of  K  points 

4 

I 

NP,  Number  of  Panels 

5 

I 

NB,  Number  of  Bodies 

6 

I 

NTP,  Nximber  of  Boxes  | 

7 

I 

NBZ,  Number  of  Z  Bodies  1 

8 

I 

NBY,  Number  of  Y  Bodies  | 
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RECORD 


2 

(cont) 


WORD 


10 


11 


12 


13 


14 


NP  WORDS 


NP  WORDS 


NP  WORDS 


NB  WORDS 


NB  WORDS 


NB  WORDS 


NB  WORDS 


NB  WORDS 


NB  WORDS 


NB  WORDS 


NB  WORDS 


NB  WORDS 


NB  WORDS 


NB  WORDS 


NB  WORDS 


NB+STRIP 


NB+STRIP 


NSTRIP 

WORDS 


NSTRIP 

WORDS 


NSTRIP 

WORDS 


NTP+ 

2NBEA1 


NTP+ 

ZNBEAl 


NTP  WORDS 


TYPE 


R 


R 


R 


R 


R 


R 


R 


R 


R 


R 


R 


R 


R 


ITEM 


NTZ,  Nximber  of  Z  Interference  Body 
Elements 


NTY,  Number  of  Y  Interference  Body 
Elements 


NTO,  Sum  of  NTP  +  NTZ  +  NTY 


NTZS,  Number  of  Z  Slender  Body 
Elements 


NTYS,  Number  of  Y  Slender  Body 
Elements 


NSTRIP,  Number  of  strips  on  panels 


NCARAY,  Boxes  per  chord 


NBARAY,  Last  box  on  panel 


NAS,  Associated  bodies  per  panel 


*NBEA1,  Number  of  interference  elements 


*NBEA2,Z-Yflag 


*NSBEA,  Number  of  slender  elements 


ZB,  Z  Body  center 


YB,  Y  Body  center 


AVR,  Half-width  of  body 


ARB,  Cross-section  aspect  ratio 


NFL,  9=distribution  per  body 


XLE,  X-leading  edge 


XTE,  X-trailing  edge 


NT121,  number  01’s  for  bodies 


NT122,  number  62’s  for  bodies 


ZS,  Z  -  of  strip  center 


YS,  Y  -  of  strip  center 


EE,  strip  half-width 


SG,  sine  of  dihedral  angle 


CG,  cosine  of  dihedral  angle 


X,  3/4  chord 


DELX,  box  chord 


XIC,  coordinates  of  center  of  pressure 
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RECORD 

WORD 

TYPE 

ITEM 

NTP  WORDS 

R 

XLAM,  tangent  of  sweepback  angle 

INSBEA 

WORDS 

R 

AO,  half-widths  for  bodies 

2NSBEA 

WORDS 

R 

XISl,  X  -  of  slender  leading  edge 

SNSBEA 

WORDS 

R 

XIS2,  X  -  of  slender  trailing  edge  I 

ZNSBEA 

WORDS 

R 

AOP,  X-derivatives  of  body  half- width 

2 

(cont) 

ZNBEAl 

WORDS 

R 

RIA,  Radius  of  interference  elements 

ZNAS 

WORDS 

I 

NASB,  associated  bodies 

ZNFL 

WORDS 

I 

IFLAl,  body  with  91  distribution 

ZNFL 

WORDS 

I 

IFLA2,  Body  with  02  distribution 

ZNT121 

WORDS 

R 

TNIA,  61’s  for  bodies 

ZNT122 

WORDS 

R 

TN2A,  62’s  for  bodies 

*Sum  of  entries  is  noted  by  NBEAi,  where  i  =  1,  2 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


AECOMPS 

Relation 

Contains  data  on  the  aerodynamic  components  in  the  planar  and  nonplanar  steady 
aerodynamics  model. 


NAME 

TYPE/KEY 

DESCRIPTION 

MODEL 

Integer 

Planar  or  nonplanar  steady  aerodynamics 
model  identifier 
=  1  for  planar  model 
=  -1  for  nonplanar  model 

ACID 

Integer 

Component  identification  number 

MACROTYPE 

Tfext  (8) 

Type  of  macroelement  (CAER06  or  PAER06) 

GROUP 

Integer 

Group  identification  number 

ACMPNT 

Text  (8) 

Component  type 

One  of  WING,  FIN,  CANARD,  POD,  or  FUSEL 

TYPE 

Integer  >  0 

Type  of  degree  of  freedom.  For  STEADY  aero 
models  all  DOF's  are  TYPE=1.  Refer  to 
AECOMPU  for  other  types. 

FIINTID 

Integer 

First  internal  degree  of  freedom  on  the 
macroelement 

NCBOX 

Integer 

Number  of  chordwise  boxes  for  lifting  surfaces 
or  number  of  circumferential  boxes  for  bodies 

NSBOX 

Integer 

Number  of  spanwise  boxes  for  lifting  surfaces 
or  number  of  axial  boxes  for  bodies 

BNDRY 

R  vector  (12) 

Coordinates  of  the  component  comers  in  basic 
coordinates 

Module  STEADY 


1.  The  boundary  coordinates  are  the  x,  y,  z  coordinates  for  each  of  the  comers  of 
lifting  elements.  Body  elements  do  not  use  BNDRY. 

The  data  are  in  the  following  order: 

(1-3)  Leading  Edge  Root 
(4-6)  Trailing  Edge  Root 
(7-9)  Trailing  Edge  Tip 
(10-12)  Leading  Edge  Tip 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes : 


Created  By: 
Notes: 


AECOMPU 

Relation 

Contains  data  on  the  aerodynamic  components  in  the  vmsteady  aerodynamics 
model. 


NAME 

TYPE/KEY 

DESCRIPTION 

ACID 

Integer 

Component  identification  number 

MACROTYPE 

Tbxt(8) 

Type  of  macroelement,  CAEROl  or  CAER02 

GROUP 

Integer 

Group  identification  number 

ACMPNT 

Text  (8) 

Component  type 

One  of  WING  or  BODY 

TYPE 

Integer  >  0 

Degree  of  freedom  type 
=2  for  WING  and  Z  body  elements 
=3  for  Y  body  elements 
=4  for  ZY  body  elements 

FIINTID 

Integer 

First  internal  degree  of  freedom  on  the 
macroelement 

NCBOX 

Integer 

Number  of  chordwise  boxes  for  lifting  surfaces 
or  number  of  circumferential  boxes  for  bodies  | 

NSBOX 

Integer 

Number  of  spanwise  boxes  for  lifting  surfaces 
or  number  of  axial  boxes  for  bodies 

I  BNDRY 

R  vector  (12) 

Coordinates  of  the  component  comers  in  basic 
coordinates 

Module  UNSTEADY 

1.  The  bormdaiy  coordinates  are  the  x,  y,  z  coordinates  for  each  of  the  comers  of 
lifting  elements.  Body  elements  do  not  use  BNDRY. 

The  data  are  in  the  following  order: 

(A)  Leading  Edge  Root 

(B)  Trailing  Edge  Root 

(C)  Trailing  Edge  Tip 

(D)  Leading  Edge  Tip 
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Entity: 

Entity  l^e: 
Description: 
Relation  Attributes: 


Created  By: 

Note: 

Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


AEFACT 

Relation 

Contains  aerodynamic  input  data  as  defined  on  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

VALUE 

Real 

Data  value 

Module  IFF 

1.  This  relation  contains  one  tuple  for  each  value  in  each  set  defined  on  the  AE¬ 
FACT  card  entry. 

AERO 

Relation 

Contains  basic  aerodynamic  data  for  use  in  unsteady  aerndynamirs  as  input  from 
the  bulk  data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

ACSID 

Integer  >  0 

Coordinate  system  identification  number  for 
the  aerod3mamic  coordinate  system 

REFC 

Real  >  0.0 

Reference  length  for  reduced  frequency 

RHOREF 

Real  >  0.0 

Reference  density 

Created  By: 


Module  IFF 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


AEROGEOM 

Relation 

Contains  the  aerodynamic  planform  geometric  grid  points  for  the  planar  and 
nonplanar  steady  aerodynamics  model.  These  grid  points  are  not  used  for  data 
recovery,  but  can  be  used  in  combination  with  the  "elements"  in  CAROGEOM  to 
create  an  ASTROS  FE  model  using  RODs  and  QUADs  that  represents  the  paneling 
of  the  aero  model. 


NAME 

TYPE/KEY 

DESCRIPTION 

MODEL 

Integer 

=1  for  the  planar  model 
=- 1  for  the  nonplanar  model 

GRIDID 

Integer 

Aerodynamic  grid  identification  number 

X 

Real 

Basic  coordinates  of  the  geometric  point 

Y 

Real 

Z 

Real 

STEADY  and/or  STEAD YNP  modrdes 


1.  These  grid  points  represent  the  airfoil  and  panel  geometry  of  the  aerody- 
namic  model  identified  by  the  MODEL  attribute.  The  connectivity  of  these 
grid  points  is  given  in  the  CAROGEOM  entity. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  by: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


AEROS 


Relation 

Contains  the  basic  parameters  for  static  aeroelasticity  as  input  from  the  Bulk  Data 
file. 


NAME 

TYPE/KEY 

DESCRIPTION 

ACSID 

Integer  >  0 

Aerodynamic  coordinate  system  identification 

RCSID 

Integer  >  0 

Reference  coordinate  system  for  rigid  body 
motions 

REFC 

Real  >  0.0 

Reference  chord  length 

REFB 

Real  >  0.0 

Reference  span 

REFS 

Real  >  0.0 

Reference  wing  area 

GREF 

Integer  >  0 

Reference  grid  point 

REFD 

Real  >  0.0 

Body  component  reference  diameter 

REFL 

Real  >  0.0 

Body  component  reference  length 

Module  IFF 

AERU6E0M 

Relation 

Contains  the  aerodynamic  planform  geometric  grid  points  for  the  flutter  analysis 
model.  These  grid  points  are  not  used  for  data  recovery,  but  can  be  used  in 
combination  with  the  "elements"  in  CAROUGEO  to  create  an  ASTROS  FE  model 
using  rod's  and  QUAD'S  that  represents  the  paneling  of  the  aero  model. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

GRIDID 

Integer 

Aerodynamic  grid  identification  number 

X 

Real 

Basic  coordinates  of  the  geometric  point 

Y 

Real 

Z 

Real 

UNSTEADY  module 

1.  The  connectivity  of  these  grid  points  is  given  in  the  CAROUGEO  entity. 
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AESURF 


Entity; 

Entity  lype: 
Description; 

Relation  Attributes; 


Created  By; 


Relation 

Contains  the  specification  of  an  aerodjuiamic  control  surface  as  input  from  the  Bulk 
Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

LABEL 

Text  (8) 

Alphanumeric  data  identifying  the  control 
surface 

TYPE 

Text  (8) 

Surface  type 

ACID 

Integer  >  0 

Aerod3Tiamic  component  identification  number 
for  control  surface  definition 

CID 

Integer  >  0 

Coordinate  system  defining  the  surface  hinge 
line 

FBOXl 

Integer  >  0 

First  aerodynamic  box  on  the  control  surface 

LBOXl 

Integer  >  0 

Last  aerod5mamic  box  on  the  control  surface  | 

Module  IFF 
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Entity: 
Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


AF 

Matrix 

Merged  from  the  AA  matrix  (see  AG). 

A6 

Subscripted  Matrix 

Contains  the  accelerations  of  the  structural  degrees  of  freedom. 

A  variable  sized  matrix  having  one  row  for  each  structural  degree  of  freedom  and 
one  column  for  each  load  condition  in  the  current  boundary  condition. 

MAPOL 

1.  The  dimension  of  this  subscripted  matrix  must  be  large  enough  for  all  optimi¬ 
zation  and  analysis  boundary  conditions. 

2.  This  entity  is  only  filled  for  analysis  of  unrestrained  structures. 

3.  The  MAPOL  sequence  recovers  this  matrix  in  the  following  order  (see  the 
Theoretical  Manual  for  the  explicity  form  of  this  recovery): 


*UM  contains  accelerations  in  the  M-set.  The  entity  name  is  reused  in  the 
MAPOL  sequence. 

AGA 

Matrix 

Contains  the  active  acceleration  vectors  for  the  current  boxmdary  condition. 

A  matrix  having  one  column  for  each  active  acceleration  vector  and  one  row  for  each 
degree  of  freedom  in  the  structural  model. 

MAPOL 

1.  This  entity  is  only  generated  during  sensitivity  evaluation  of  imrestrained 
boxmdary  conditions. 
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Entity: 
Entity  Type: 
Description: 


Matrix  Form: 

Created  By: 
Notes: 


Entity: 


Entity  Type: 
Description: 


Matrix  Form: 


Created  By: 
Notes: 


AICMAT 

Subscripted  Matrix 

Aerodynamic  influence  coefficient  matrix  for  a  S3rmmetric  boundary  condition  and 
a  given  Mach  number.  The  Mach  number  associated  with  a  given  subscript  is  given 
in  the  TRIM  relation. 

Square,  real  and  asymmetric.  The  dimension  of  the  matrix  is  equal  to  the  number 
of  panels  in  the  steady  aerodynamics  USSAERO  model. 

Module  STEADY 

1.  STEADY  creates  as  many  matrices  as  there  are  distinct  symmetric  Mach 
numbers  in  the  user’s  input  packet.  If  a  combination  of  S3nnmetric  and  anti¬ 
symmetric  Mach  numbers  are  used,  the  MINDEX  changes  for  each  distinct 
Mach  number.  An  AICMAT  entity  is  created  for  a  given  MINDEX  o^y  if  the 
corresponding  Mach  number  requires  the  symmetric  boundary  conditions.  It 
is  possible,  therefore,  that,  in  the  range  from  1  to  MINDEX,  some  subscript 
values  wiU  not  have  a  corresponding  AICMAT. 


AICS 

Matrix 

Steady  aerodynamic  influence  coefficient  matrix  for  a  given  boimdary  condition  in 
the  structural  coordinates. 

Square,  real  and  asymmetric.  The  dimension  of  the  matrix  is  equal  to  the  number 
of  degrees  of  freedom  in  the  f-set. 

MAPOL 

1.  This  matrix  is  derived  from  splining  the  AICMAT  or  AAICMAT  matrix  to  the 
structural  degrees  of  freedom. 
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Entity: 

Entity  T^e: 
Description: 

Relation  Attributes: 


Created  By: 


AIRFOIL 

Relation 

Contains  the  airfoil  properties  to  be  used  in  the  aerodynamic  analyses  as  defined 
on  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

ACID 

Integer  >  0 

Aircraft  component  identification  number  | 

ACMPNT 

Tbxt  (8) 

Component  type  (i.e.  WING)  | 

CP 

Integer  >  0 

Coordinate  system  identification  number  1 

CHORD 

Integer  >  0 

AEFACT  setid  for  the  chordwise  division 
points 

UST 

Integer  >  0 

AEFACT  setid  for  the  upper  surface  half 
thicknesses 

LST 

Integer  >  0 

AEFACT  setid  for  the  lower  surface  half 
thicknesses  | 

CAMBER 

Integer  >  0 

—  — - - - - 

AEFACT  setid  for  the  camber  ordinants 

RADIUS 

Real  >  0 

Airfoil  leading  edge  radius 

XI,  Yl,  Z1 

Real 

Location  of  point  1  in  coordinate  system  CP 

XI 2 

Real  >  0.0 

Edge  chord  length  in  coordinate  system  CP 

IPANEL 

Integer  >  0 

AEFACT  setid  containing  chordwise  cuts  for 
wing  paneling 

IFF  Module 
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Entity: 
Entity  Type: 
Description: 


Matrix  Form: 


Created  By: 
Notes: 


AIRFRC 

Subscripted  Matrix 

Rigid  body  aerodynamic  load  vectors  for  a  given  Mach  number.  There  is  one  vector 
for  each  configuration  parameter  associated  with  the  Mach  index.  There  are  six 
symmetric  parameters:  NX,  NZ,  QACCEL,  THKCAM,  ALPHA  and  QRATE  and  6 
antisymmetric  parameters:  NY,  PACCEL,  RACCEL,  BETA,  PRATE,  RRATE.  In 
addition,  each  symmetric  and  antisymmetric  control  surface  AESURF  will  generate 
a  column.  For  a  given  subscript,  the  AIRFRC  matrix  contains  the  six  columns  for 
the  symmetric  parameters  plus  one  column  for  each  symmetric  AESURF  if  the 
SYMMETRIC  forces  are  needed  for  the  associated  Mach  number.  It  contains  six 
columns  for  the  antisymmetric  parameters  and  one  column  for  each  antis3mimetric 
AESURF  if  the  ANTISYMMETRIC  forces  are  needed  for  the  associated  Mach 
number.  If  both  are  needed,  all  12  parameters  and  all  AESURF  entries  in  the  model 
have  columns.  The  ordering  of  the  columns  corresponds  to  the  order  of  entries  in  the 
STABCF  entity. 

Rectangular  and  real.  The  number  of  rows  is  equal  to  the  number  of  panels  in  the 
steady  aerodynamics  model  while  the  nximber  of  columns  is  equal  to  the  number  of 
entries  in  the  STABCF  relation  that  have  the  same  MACHINDX  value  as  the 
subscript  value.  The  columns  of  AIRFRC  are  stored  in  the  same  order  as  the  entries 
in  STABCF.  Refer  to  the  STABCF  entity  for  more  details. 

STEADY  Module 

1.  STEADY  creates  as  many  matrices  as  there  are  distinct  Mach  numbers  in 
the  bulk  data  packet. 


Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


AJJTL 

Matrix 

List  of  unsteady  aerodjmamic  matrices  to  compute  panel  pressures  due  to  slopes  at 
the  control  point. 

Square,  complex  matrix  with  the  number  of  rows  and  colums  equal  to  the  number 
of  aerod3mamic  panels. 

AMP 

1.  AJJTL  is  a  matrix  list  with  the  number  of  matrices  equal  to  the  number  of  M» 
k  pairs  in  the  input  stream. 


Entity: 


AL 


Entity  Type: 
Description: 


Matrix 

Acceleration  in  the  1-set  obtained  firom  D  and  AR  (see  AG). 
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Entity: 

Entity  IVpe: 
Description: 

Matrix  Form: 

Created  By: 

Notes: 


Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


AMAT 

Matrix 

Matrix  containing  the  sensitivity  of  the  constraints  to  changes  in  the  design 
variables. 

The  number  of  columns  is  equal  to  the  number  of  active  constraints.  The  number 
of  rows  is  equal  to  the  number  of  design  variables. 

Modules  ACTCON,  AEROEFFS,  AEROSENS,  FREQSENS,  FLUTSENS, 
MAKDFV,  MKAMAT,  andLAMINSNS 

1.  The  columns  are  written  in  the  order  they  appear  on  the  CONST  relation  ex¬ 
cept  that,  for  a  given  boundary  condition,  all  the  constraints  for  a  given  sub¬ 
case  are  grouped  together.  On  the  CONST  relation,  these  constraints  are 
grouped  by  t5q)e. 

2.  See  CONST. 

3.  CONST  and  AMAT  are  brought  into  alignment  in  DESIGN  where  the 
CONST  tuples  are  ordered  to  have  all  subcases  grouped  together. 

AR 

Matrix 

Contains  the  accelerations  for  the  support  degrees  of  freedom  (see  AG). 

A  variable  sized  matrix  having  one  row  for  each  support  degree  of  freedom  and  one 
column  for  each  load  condition  in  the  current  boxmdary  condition. 

Module  INERTIA 

1.  This  matrix  is  only  formed  for  the  analysis  of  unrestrained  structures. 

ASET 

Relation 

Contains  the  external  grid  identification  numbers  and  components  associated  with 
the  analysis  set  as  defined  on  the  ASET  entries  of  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

ASET  identification  number 

GRIDl 

Integer  >  0 

Grid  or  scalar  point  identification  number 

COMPNTS 

Integer  >  0 

Component  number;  Zero  for  scalar  points,  1-6 
for  grid  points 

Module  IFF 

1.  Used  by  the  MEUSET  module  to  build  the  USET  relation. 
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Entity; 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


ASETl 

Relation 

Contains  the  external  grid  identification  numbers  and  components  associated  with 
the  analysis  set  as  defined  on  the  ASETl  entries  of  the  Bulk  Data  file. 


1  NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

ASET  identification  nmnber 

COMPNTS 

Integer  >  0 

Component  number;  Zero  for  scalar  points,  1-6 
for  grid  points 

GRIDl 

Integer  >  0 

Grid  or  scalar  point  identification  number 

Module  IFF 

1.  Used  by  the  MKUSET  module  to  build  the  USET  relation. 

ATTACH 

Relation 

Contains  the  definitions  of  aerodynamic  boxes  whose  forces  are  to  be  attached  to  a 
referenced  grid  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

MACROID 

Integer  >  0 

Element  identification  number  of  an 
aerodynamic  macroelement  | 

IDl 

Integer  >  0 

External  box  identification  number  of  the  first 
aero  box  on  the  macroelement  I 

1  ID2 

Integer  >  0 

External  box  identification  number  of  the  last  1 
aero  box  on  the  macroelement 

REFGRD 

Integer  >  0 

The  external  identification  number  of  the  1 

referenced  grid  point  1 

Module  IFF 
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AXSTA 


Entity: 

Entity  TVpe:  Relation 

Description:  Contains  the  body  axial  station  parameters  for  the  aerodynamic  model  as  input  from 

the  Bulk  Data  file. 

Relation  Attributes : 


NAME 

TYPE/KEY 

DESCRIPTION  I 

BCID 

Integer  >  0 

Body  component  identification  number  | 

XSTA 

Real 

X  ordinate  of  body  station  | 

CBOD 

Real 

Z  ordinate  of  body  station 

ABOD 

Real  >  0.0 

Body  cross-sectional  area  at  XBOD 

YRAD 

Integer  >  0 

AEFACT  setid  containing  the  y-ordinates  of 
the  body  section  | 

ZRAD 

Integer  >  0 

AEFACT  setid  containing  the  Z-ordinates  of  I 
the  body  section  | 

Created  By: 

Module  IFF 

Entity: 

BDD 

Entity  Type: 

Matrix 

Description: 

Damping  matrix  in  the  direct  dynamic  set. 

Matrix  Form: 

Square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number  of  degrees 
of  freedom  in  the  d-set. 

Created  By: 

DMA 
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beamest 

Relation 

Contains  the  element  summary  data  for  the  BAR  element. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

EID 

Integer  >  0,  key 

Element  identification  number  I 

PID 

Integer  >  0 

Element  property  identification  I 

number 

PTYPE 

Text(8) 

Element  property  type 

SILl 

Integer  >  0 

Internal  grid  point  id  for  end  A 

SIL2 

Integer  >  0 

Internal  grid  point  id  for  end  B 

ORIENTX 

Real 

Orientation  vector  for  element 

ORIENTY 

Real 

ORIENTZ 

Real 

ICSSV 

Integer  >  0 

The  external  coordinate  system  in 
which  the  orientation  vector  is 
defined. 

PINA,  PINE 

Integer  >  0 

The  offset  pinned  degrees  of  freedom  1 
for  ends  A  and  B 

OFFSETAX 

Real 

The  offset  vectors  for  ends  A  and  B 

OFFSETAY 

Real 

OFFSETAZ 

Real 

OFFSETBX 

Real 

OFFSETBY 

Real 

OFFSETBZ 

Real 

MIDI 

Integer  >  0 

The  material  id  for  the  element 

AREA 

Real  >  0 

The  beam  cross-sectional  area 

11 

Real>0 

The  area  moment  of  inertia  (Plane  1) 

12 

Real  >  0 

The  area  moment  of  inertia  (Plane  2) 

TORSION 

Real  >  0 

The  beam  torsional  constant  | 

1  NSM 

Real  >  0 

The  beam  non  structural  mass 

1  Cl,  C2,  Dl,  D2 

Real 

Element  stress  recovery  coefficients 

1  El,  E2,  FI,  F2 

Real 

1  KFACTl 

Real 

Shear  area  factor  (plane  1) 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 
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NAME 

TYPE/KEY 

DESCRIPTION 

KFACT2 

Real 

Shear  area  factor  (plane  2) 

112 

Real 

Beam  product  of  inertia 

RISQR 

Real 

Inertia  term;  Definition  for  design 

R2SQR 

Real 

ALPHA 

Real 

COORDl 

Integer  >  0 

External  coordinate  system  of  end  A 

XI,  Yl,  Z1 

Real 

Basic  coordinates  of  end  A 

COORD2 

Integer  >  0 

External  coordinate  system  of  end  B 

X2,  Y2,  Z2 

Real 

Basic  coordinates  of  end  B 

SCON 

Integer 

Stress  constraint  flag 

DESIGN 

Integer 

Design  flag 

DSEC4 


Real  >  0.0 


STHRM 

Real 

Thermal  stress  term 

STHRMA 

Real 

Thermal  strain  term 

TREFPT 

Integer 

Pointer  to  TREF  entity  for  thermal 
stress/load  evaluation 

NLFLAG 

Integer  >  0 

Design  variable  nonlinear  flag 
=  0  Design  variable  is  linear 
=  1  Designed  element  using 

PBARl  property,  design 
variable  is  nonlinear 

SHAPE 

TBxt(8) 

Cross  section  shape 

NDSEC 

Integer  >  0 

Number  of  dimensions 

DSECl 

Real  >  0.0 

Cross  section  dimension  1 

DlDESl 

Integer  >  0 

Design  flag  for  dimension  1 
=  1  Designed  dimension 
=  0  Non-designed  demension 

DSEC2 

Real  >  0.0 

Cross  section  dimension  2 

D2DES 

Integer  >  0 

Design  flag  for  dimension  2 
=  1  Designed  dimension 
=  0  Non-designed  demension 

DSEC3 

Real  >  0.0 

Cross  section  dimension  3 

D3DES 

Integer  >  0 

Design  flag  for  dimension  3 
=  1  Designed  dimension 
=  0  Non-designed  demension 

Cross  section  dimension  4 


NAME 

TYPE/KEY 

DESCRIPTION 

D4DES 

Integer  >  0 

Design  flag  for  dimension  4 
=  1  Designed  dimension 
=  0  Non-designed  demension 

DSEC5 

Real  >  0.0 

Cross  section  dimension  5  | 

D5DES 

Integer  >  0 

Design  flag  for  dimension  5 
=  1  Designed  dimension 
=  0  Non-designed  demension 

DSEC6 

Real  >  0.0 

Cross  section  dimension  6 

D6DES 

Integer  >  0 

Design  flag  for  dimension  6 
=  1  Designed  dimension 
=  0  Non-designed  demension 

DSEC7 

Real  >  0.0 

Cross  section  dimension  7 

D7DES 

Integer  >  0 

Design  flag  for  dimension  7 
=  1  Designed  dimension 
=  0  Non-designed  demension 

DSEC8 

Real  >  0.0 

Cross  section  dimension  8 

D8DES 

Integer  >  0 

Design  flag  for  dimension  8 
=  1  Designed  dimension 
=  0  Non-designed  demension 

DSEC9 

Real  >  0.0 

Cross  section  dimension  9 

D9DES 

Integer  >  0 

Design  flag  for  dimension  9 
=  1  Designed  dimension 
=  0  Non-designed  demension 

I  DSECIO 

Real  >  0.0 

Cross  section  dimension  10 

DIODES 

Integer  >  0 

Design  flag  for  dimension  10  | 

=  1  Designed  dimension 
=  0  Non-designed  demension  | 

ELRSPREQ 

Integer 

User  function  element  response  flag 
=  1  Element  response  reqmred 
=  0  Element  response  not  required 

Created  by: 
Notes: 


Module  MAKEST 


1.  This  relation  contains  one  tuple  for  each  beam  element  in  the  problem.  It  is 

built  from  the  GEAR,  PEAR  and  associated  material  and  design  relations. 
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Entity: 

Entity  IVpe: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  IVpe: 
Description: 
Relation  Attributes: 


Created  by: 
Notes: 


BFRC 

Matrix 

Matrix  of  rigid  body  load  vectors  for  unit  values  of  angle  of  attack,  pitch  rate  and 
trim  surface  deflection. 

Rectangular  real  matrix  with  three  colmnns  and  rows  equal  to  the  number  of  panels 
in  the  unsteady  aerodynamics  model. 

Module  BLASTFIT 

BGPDT 

Relation 

Contains  the  coordinates  of  the  grid  points  in  the  basic  coordinate  system. 


NAME 

TYPE/KEY 

DESCRIPTION 

EXTID 

Integer  >  0 

The  grid  or  scalar  point  external  identification 
number 

INTID 

Integer  >  0 

Equivalent  internal  identification  number 

FLAG 

Integer  >  0 

Flag  indicating  the  point  is  a  grid  point  or  a 
scalar  point 

CD 

Integer 

The  displacement  coordinate  system  for  the 
grid  point 

X,  Y,  Z 

Real 

Spatial  coordinates  of  the  point  in  the  basic 
coordinate  system 

Module  BCBGPDT 

1.  This  relation  contains  one  tuple  for  each  grid  or  scalar  point  in  the  problem. 

2.  This  relation  is  built  from  the  GRID,  SPOINT,  EPOINT,  CSTM  and  SEQGP 
relations. 

3.  The  FLAG  equals  6  if  the  point  is  a  grid  point  and  equals  1  if  a  scalar  point 
and  0  if  not  in  the  g-set. 

4.  The  internal  identification  number  is  determined  by  assigning  INTID  in  in¬ 
creasing  order  of  EXTID’s. 

5.  Scalar  points  are  also  denoted  by  CD=-1;  X=Y=Z=0.0. 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


BHH 

Matrix 

Damping  matrix  in  the  modal  dynamic  set. 

Square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number  of  degrees 
of  freedom  in  the  h-set. 

DMA 

1.  Info  (11)  for  the  entity  contains  a  coupled  flag 
=  0  Uncoupled 

=  1  Coupled 

2.  Info  (12)  contains  damping  data 
=  0  Modal  damping  only 

=  1  Viscous  damping  only 
=  2  Both  modal  and  viscous  damping 


Entity: 

Entity  TVpe: 
Description: 

Relation  Attributes: 


BLAST 

Relation 

Contains  the  definition  of  parameters  for  use  in  nuclear  blast  response  analysis  as 
input  from  the  bulk  data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

BLID 

Integer  >  0 

Blast  set  ID 

ALT 

Real  >  0.0 

Aircraft  altitude 

VEL 

Real  >  0.0 

Aircraft  velocity 

WKT 

Real  >  0.0 

Weapon  yield 

HGRD 

Real 

Height  of  the  ground 

KGRD 

Integer 

Flag  denoting  presence  of  ground 

BALT 

Real 

Blast  altitude 

MACH 

Real 

Mach  number 

DELTAX 

Real 

X-distance  from  A/C  to  blast 

DELTAY 

Real 

Y-distance  fi-om  A/C  to  blast 

TMIN 

Real  >  0.0 

Miniinum  time  used  in  curve  fit 

TMAX 

Real  >  0.0 

Maximmn  time  used  in  oorve  fit 

NTIME 

Integer  >  0 

Number  of  time  steps 

BMIN 

Real  >  0 

Minimum  decay  value  used  in  curve  fit 

BMAX 

Real  >  0 

Maximmn  decay  value  used  in  curve  fit 

NBETA 

Integer  >  0 

Nximber  of  decay  values 

SYMXY 

Integer 

Symmetry  flag  for  xy  plane  I 

XYMXZ 

Integer 

Symmetry  flag  for  xz  plane 

TRSURF 

Tfext  (8) 

Trim  surface  label 

NZ 

Real 

Load  factor  for  trim  calculation 

Created  By: 
Notes: 


Module  IFF 


Entity: 

Entity  lype: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


BLGTJA 

Matrix 

A  partition  of  matrix  UGTKAused  in  the  nuclear  blast  analysis  to  spline  aerody¬ 
namic  forces  to  the  structure. 

Rectangular  real  matrix  having  one  row  for  each  structural  degree  of  freedom  in  the 
a-set  and  one  column  for  each  panel  in  the  unsteady  aerodynamics  model. 

Module  BLASTFIT 

BLSTJA 

Matrix 

Apartition  of  matrix  UGTKAused  in  the  nuclear  blast  analysis  to  spline  structural 
displacements  to  the  panel  slopes. 

Rectangular  real  matrix  having  one  row  for  each  structural  degree  of  freedom  in  the 
a-set  and  one  column  for  each  panel  in  the  unsteady  aerodynamics  model. 

Module  BLASTFIT 

BODY 

Relation 

Contains  the  body  configuration  parameters  for  the  aerodynamic  model  as  input 
from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

BCID 

Integer  >  0,  key 

Body  component  id 

ACMPNT 

Tfext  (8) 

Component  type  (i.e.,  POD) 

CP 

Integer  >  0 

Coordinate  system  id  for  geometry  input 

NRAD 

Integer  >  0 

Number  of  equal  body  cuts  used  to  define 
the  body  panels 

X,  Y,  Z 

Real 

Ordinates  of  the  body  in  coordinate  system 
CP 

Created  By: 


Module  IFF 


Entity: 

Entity  IVpe: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


STEM 

Matrix 

A  scratch  matrix  in  the  blast  calculation. 

Rectangular  real  matrix  with  the  number  of  rows  equal  to  the  number  of  elastic 
modes  retained  in  the  blast  analysis  and  three  columns. 

MAPOL 

1.  This  matrix  is  the  solution  to  the  equation: 

[  KEQE  ]  *  [  STEM  ]  =  [  GFE  ] 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes : 


Created  By: 


CAEROl 

Relation 

Contains  an  aerodynamic  macroelement  (panel)  in  terms  of  two  leading-edge 
locations  and  side  chords.  This  is  used  for  unsteady  aerodynamics. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

PID 

Integer  >  0 

Identification  number  of  property  card.  Used  to 
specify  associated  bodies 

CP 

Integer  >  0 

Coordinate  system  for  locating  points  1  and  4 

NSPAN 

Integer  >  0 

Number  of  spanwise  boxes;  if  a  positive  value 
is  given  NSPAN,  equal  divisions  are  assumed; 
if  zero  or  blank,  a  list  of  division  points  is  given 
at  LSPAN 

NCHORD 

Integer  >  0 

Number  of  chordwise  boxes;  if  a  positive  value 
is  given  NCHORD,  equal  divisions  are 
assumed;  if  zero  or  blank,  a  list  of  division 
points  is  given  at  LCHORD 

LSPAN 

Integer  >  0 

ID  of  an  AEFACT  data  card  containing  a  fist  of  j 
division  points  for  spanwise  boxes.  Used  only  if  1 
NSPAN  is  zero  or  blank 

LCHORD 

Integer  >  0 

ID  of  an  AEFACT  data  card  containing  a  list  of 
division  points  for  chordwise  boxes.  Used  only 
if  NCORD  is  zero  or  blank  1 

IGID 

Integer  >  0 

Interference  group  identification  (aerodynamic  I 
elements  with  different  IGID’s  are  imcoupled) 

XI,  Yl,  Z1 

Real 

Location  of  point  1  in  coordinate  system  CP  j 

X12 

Real  >  0 

Edge  chord  length  (in  aerodynamic  coordinate  1 
system)  (Cannot  be  zero  if  X43  is  zero)  1 

X4,  Y4,  Z4 

Real 

Location  of  point  4  in  coordinate  system  CP 

X43 

Real  >  0 

Edge  chord  length  (in  aerodynamic  coordinate  j 
system)(Cannot  be  zero  if  X12  is  zero)  j 

Modide  IFP 
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Entity; 

Entity  'lype: 
Description: 

Relation  Attributes: 


Created  By: 


CAER02 

Relation 

Contains  the  definition  of  an  aerodynamic  body  for  unsteady  aerodynamics  as  input 
from  the  bulk  data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

PID 

Integer  >  0 

Property  identification  number 

CP 

Integer  >  0 

Coordinate  system  for  locating  point  1 

NSB 

Integer  >  0 

Number  of  slender  body  elements 

NINT 

Integer  >  0 

Number  of  interference  elements 

LSB 

Integer  >  0 

AEFACT  identification  number  defining 
slender  body  division  points 

LINT 

Integer  >  0 

AEFACT  identification  number  defining 
interference  element  division  points 

IGID 

Integer  >  0 

Interference  group  identification 

XI,  Yl,  Z1 

Real 

Location  of  point  1  in  coordinate  system  CP 

X12 

Real  >  0.0 

Length  of  the  body  in  the  x-axis  of  the 
aerodynamic  coordinate  system 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes : 


Created  By: 


CAER06 

Relation 

Contains  the  definition  of  an  aerodynamic  macroelement  used  in  aerodynamic 
analyses  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

ACID 

Integer  >  0 

Aircraft  component  identification  number 

ACMPNT 

Tfext  (8) 

Component  type  (i.e.,  WING) 

CP 

Integer  >  0 

Coordinate  system  identification  number  for 
geometry  input 

GROUP 

Integer  >  0 

Group  identification  number 

SPAN 

Integer  >  0 

AEFACT  setid  for  the  division  points  of 
spanwise  boxes 

CHORD 

Integer  >  0 

AEFACT  setid  for  the  chordwise  division  points 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CAR06E0M 

Relation 

Contains  the  connectivity  data  for  the  aerod3Tiamic  planform  of  the  planar  and 
nonplanar  steady  aerodynamics  model.  These  elements  are  not  used  for  data 
recovery,  but  can  be  used  in  combination  with  the  "grids"  in  AEROGEOM  to  create 
an  ASTROS  FE  model  using  RODs  and  QUADs  that  represents  the  paneling  of  the 
aero  model. 


NAME 

TYPE/KEY 

DESCRIPTION 

MODEL 

Integer 

=  1  for  the  planar  model 
=  -1  for  the  nonplanar  model 

EID 

Integer  >  0 

External  aerodynamic  box  identification 
number 

INTEID 

Integer  >  0 

Internal  aerodynamic  box  identification 
number  (aerodynamic  degree  of  freedom 
number)  see  Remark  2 

MACROID 

Integer  >  0 

Macroelement  identification  number  on  which 
the  box  hes 

MACROTYP 

Ifext  (8) 

Macroelement  type  (e.g.  PAER06,  CAER06) 

CMPNT 

Ttext  (8) 

Component  type  (FIN,  CANARD,  WING, 

FUSEL,  of  POD) 

NGRID 

Integer  >  0 

Number  of  grids  connected  to  the  box 
=  4  or  3  for  panels 
=  2  for  airfoil  line  segments 

GRIDl 

! 

Integer  >  0 

Grid  identification  number  of  an  AEROGEOM 
grid  for  inboard/upstream  location 

GRID2 

Integer  >  0 

Grid  identification  number  of  an  AEROGEOM 
grid  for  inboard/downstream  location 

GRID3 

Integer  >  0 

Grid  identification  number  of  AEROGEOM 
grid  for  outboard/downstream  location 

GRID4 

Integer  >  0 

Grid  identification  number  of  AEROGEOM 
grid  for  outboard/upstream  location 

STEADY  and/or  STEADYNP  modules 

1.  The  grid  points  referred  to  by  this  relation  are  stored  in  the  AEROGEOM  en¬ 
tity. 

2.  Airfoil  geometry  is  also  defined  by  this  relation  but  the  "elements"  are  line 
segments  not  related  to  the  control  points  of  the  panel  model.  For  these  ele¬ 
ments,  the  internal  identification  number  is  set  to  -  1  rather  than  the  degree 
of  freedom  identifier  in  solution  matrices. 

3.  Airfoil  geometry  is  defined  by  any  and  all  elements  with  NGRID=2. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes : 


Created  By: 
Notes: 


CAR0U6E0 

Relation 

Contains  the  connectivity  data  for  the  aerodynamic  planform  of  the  flutter  analysis 
model.  These  elements  are  not  used  for  data  recovery,  but  can  be  used  in  combination 
with  the  "grids"  in  AERUGEOM  to  create  an  ASTROS  FE  model  using  ROD’S  and 
quad’s  that  represents  the  paneling  of  the  aero  model. 


NAME 

TYPE/KEY 

DESCRIPTION 

EXTID 

Integer  >  0 

External  aerodynamic  box  identification 
number 

INTEID 

Integer  >  0 

Internal  aerodynamic  box  identification 
number  (aerod5mamic  degree  of  freedom 
number)  see  Remark  2 

MACROID 

Integer  >  0 

Macroelement  identification  number  on  which 
the  box  lies 

NGRID 

Integer  >  0 

Number  of  grids  connected  to  the  box 
=  4  or  3  for  panels 
=  2  for  airfoil  line  segments 

MACROTYP 

Itext  (8) 

Macroelement  type  (e,g.  PAER06,  CAER06) 

IGID 

Integer  >  0 

Interference  group  identification 

GRIDl 

Integer  >  0 

Grid  identification  number  of  an  AEROGEOM 
grid  for  inboard/upstream  location 

GRID2 

Integer  >  0 

Grid  identification  number  of  an  AEROGEOM 
grid  for  inboard/downstream  location 

GRIDS 

Integer  >  0 

Grid  identification  number  of  AEROGEOM 
grid  for  outboard/downstream  location 

GRID4 

Integer  >  0 

Grid  identification  number  of  AEROGEOM 
grid  for  outboard/upstream  location 

UNSTEADY  module 

1.  The  grid  points  referred  to  by  this  relation  are  stored  in  the  AERUGEOM  en- 

tity- 

2.  Airfoil  geometry  is  also  defined  by  this  relation  but  the  "elements"  are  line 
segments  not  related  to  the  control  points  of  the  panel  model.  For  these  ele¬ 
ments,  the  internal  identification  niunber  is  set  to  -  1  rather  than  the  degree 
of  freedom  identifier  in  solution  matrices. 

3.  Airfoil  geometry  is  defined  by  any  and  all  elements  with  NGRID=2. 


Entity: 

Entity  T^pe: 
Description: 

Relation  Attributes : 


CASE 

Relation 

Contains  the  case  parameters  for  each  analysis  within  each  boundary  condition  as 
input  in  the  solution  control  packet. 


NAME 

TYPE/KEY 

DESCRIPTION 

OAFLAG 

Integer  >  0 

Optimize/analyze  flag 
=  1  Optimize 
=  2  Analyze 

BCID 

Integer  >  0 

Subcase  identification  number 

CASEID 

Integer  >  0,  Key 

Boundary  condition  identification 
number 

MPCSETID 

Integer 

Multipoint  constraint  set  identification 
number 

SPCSETID 

Integer 

Single  point  constraint  set 
identification  number 

REDSETID 

Integer 

Guyan  reduction  constraint  set 
identification  number 

SUPSETID 

Integer 

Support  set  identification  number 

METHOD 

Integer 

Real  eigenvalue  extraction  method  set 
identification  number 

CMETHOD 

Integer 

Complex  eigenvalue  extraction  method 
set  identification  number 

DYNRED 

Integer 

Dynamic  reduction  set  identification 
number  j 

INERTIA 

Integer 

Inertia  relief  mode  shapes  set  1 

identification  niimber 

TFSETID 

Integer 

Transfer  function  set  identification 
number 

K2PP 

Ifext  (8) 

K2PP  name 

M2PP 

Ifext  (8) 

M2PP  name 

B2PP 

Text  (8) 

B2PP  name 

K2GG 

Text  (8) 

K2GG  name 

M2GG 

Text  (8) 

M2GG  name  j 
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NAME 


TYPE/KEY 


DESCRIPTION 


DISFLAG  Integer 


MECHLOAD 


THRMLOAD 


TRIMID 


Integer 


DCONFID 

DLOADID 


Integer 


Integer 


Integer 


Integer 

Integer 


Discipline  flag 
=  1  Statics 
=  2  Modes 
=  3  Saero 
=  4  Flutter 
=  5  Transient 
=  6  Frequency 
=  7  Buckling 
=  8  Blast 

=  9  Nonplanar  Saero _ _ 

Mechanical  load  set  identification 
number _ 


Thermal  load  set  identification  number 


Gravity  load  set  identification  number 


Trim  set  identification  number 


Trim  symmetry  flag 
=  -1  Antisymmetric 

=  0  Asjonmetric 

=  1  Symmetric 


Design  constraint  set  identification 
number  _ _ 


Stress  constraint  set  identification 
number _ _ _ _ 

Strain  constraint  set  identification 
number  _ 


DCONF  identifiction  number _ 

Dynamic  load  set  identification  number 


Dynamic  response  method 
=  1  Direct 

=  2  Modal _ _ 

Time  step  set  identification  number 


Frequency  step  set  identification 
nmnber  _ 


Fast  Fourier  transform  set 
identification  number  _ 


Gust  set  identification  number 


INITCON 

Integer 

Initial  condition  set  identification  j 

number  I 

RANDOMID 

Integer 

Random  set  identification  number 

BLASTED 

Integer 

Blast  set  identification  number 

BUCKLEID 

Integer 

Buckling  eigenvalue  extraction  set 
identification  number 

FLUTID 

Integer 

Flutter  set  identification  number 
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NAME 


TYPE/KEY 


DESCRIPTION 


CONTROL 


DAMPID 


ESET 


Tfext  (8) 


Integer 


Integer 


ACCEPRNT 


Name  of  aerod5niamic  extra  point 
splining  matrix _ 


Damping  set  identification  number 


Extra  point  set  identification  number 


Integer  vector  (20) 


AIRDPRNT 


DISPPRNT 


ENERPRNT 


FORCPRNT 


GPFOPRNT 


Integer  vector  (20) 


Integer  vector  (20) 


Integer  vector  (20) 


Integer  vector  (20) 


Integer  vector  (20) 


Acceleration  print  selection 
WORD  1  Print  set  identification 
number  >  0,  or 
=  0  NONE 
=  -l  ALL 
=  ~2  LAST 

WORD  2  Punch  set  identification 
number 

WORD  3  Print  form 
=  0  Rectangular 
=  1  Polar 

WORD  4  Punch  form 

WORD  5  Print  frequency  set 

identification  number 

WORD  6  Punch  fi'equency  set 

identification  number 

WORD  7  Print  iteration  set 

identification  number 

WORD  8  Punch  iteration  set 

identification  number 

WORD  9  Print  mode  set  identification 

number 

WORD  10  Punch  maode  set 

identification  number 

WORD  11  Print  time  set  identification 

number 

WORD  12  Punch  time  set 
identification  number 


Aerodynamic  displacement  print 
selection 


Displacement  print  selection 
WORD  1  Print  set  identification 
number 

WORD  2  Punch  set  identification 
number 

WORD  3  Print  form 
=  0  Rectangular 
=  1  Polar 

WORD  4  Pomch  form 


Strain  energy  print  selection 


Element  force  print  selection 


Grid  point  force  print  selection 
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Created  By: 
Notes: 


NAME 

TYPE/KEY 

DESCRIPTION 

GPWGPKNT 

Integer  vector  (20) 

Grid  point  weight  generation  print 
selection 

LOADPRNT 

Integer  vector  (20) 

Load  print  selection 

MASSPRNT 

Integer  vector  (20) 

Mass  matrix  print  selection 

MPCFPRNT 

Integer  vector  (20) 

Multi-point  constraint  force  print 
selection 

QHHPRNT 

Integer  vector  (20) 

QHH  matrix  print  selection 

QHJPRNT 

Integer  vector  (20) 

QHJ  matrix  print  selection 

ROOTPRNT 

Integer  vector  (20) 

Flutter  and  normal  modes  eigenvalue 
print  selection 

SPCFPRNT 

Integer  vector  (20) 

Single  point  constraint  force  print 
selection 

STIFPKNT 

Integer  vector  (20) 

Stif&iess  matrix  print  selection 

STRAPRNT 

Integer  vector  (20) 

strain  print  selection 

WORD  13  Print  layer/laminate  option 
WORD  14  Pimch  layer/laminate  option 
=  0  Layer  strain 
=  1  Laminate  strain 
=  2  Both  layer  and  laminate  strain 

STREPRNT 

Integer  vector  (20) 

Stress  print  selection 

WORD  13  Print  layer/laminate  option 
WORD  14  Punch  layer/laminate  option 
=  0  Layer  stress 
=  1  Laminate  stress 
=  2  Both  layer  and  laminate  stress 

TPREPRNT 

Integer  vector  (20) 

Trim  pressure  coefficient  print  selection 

VELOPRNT 

Integer  vector  (20) 

Velocity  print  selection 

TRIMPRNT 

Integer 

Steady  aeroelastic  trim  print  toggle 

TITLE 

Tfext  (72) 

User  label  TITLE  I 

SUBTITLE 

’Ifext(72) 

User  label  SUBTITLE  | 

LABEL 

Ifext  (72) 

User  label  LABEL  1 

Module  SOLUTION 


1.  The  format  of  the  ACCEPRNT  vector  is  typical  of  the  format  of  all  the  print 
selection  vectors.  Additionally,  the  format  for  the  print  set  Identification  num¬ 
ber  in  the  ACCEPRNT  vector  is  lypical  of  that  of  the  other  set  Identification 
nxnnbers  in  the  vector. 

2.  The  CASE,  JOB  and  OPTIMIZE  relation  entities  together  contain  the  solu¬ 
tion  control  requests  as  input  in  the  solution  control  packet.  CASE  contains 
the  case-dependent  parameters,  JOB  contains  the  case-independent  requests 
and  OPTIMIZE  contains  the  optimization-dependent  requests. 
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Entity: 

Entity  T^e; 
Description: 
Relation  Attributes: 


Created  By: 


CASELIST 

Relation 

Contains  the  list  of  subcase  identification  numbers  as  input  firom  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID  i 

Integer 

Set  identification  number 

CASEID 

Integer 

Subcase  identification  number 

Module  IFF. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CBAR 

Relation 

Contains  the  element  connectivity  data  for  the  BAR  element  as  input  from  the  Bulk 
Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

PIDl 

Integer  >  0 

Property  identification  number  of  a  PBAR 
tuple 

GRIDl 

Integer  >  0 

Grid  point  identification  for  end  A 

GRID2 

Integer  >  0 

Grid  point  identification  for  end  B 

GRID3 

Integer  >  0 

Grid  point  identification  for  orientation 
vector  definition 

ORIENTX 

Real 

Orientation  vector 

ORIENTY 

Real 

ORIENTZ 

Real 

TMAX 

Read 

Maximum  area  for  design 

PINA 

Integer  >  0 

Components  pinned  at  end  A 

PINE 

Integer  >  0 

Components  pinned  at  end  B 

OFFSETAX 

Real 

Offsets  from  GRIDl  and  GRID2  to  the 
ends  of  the  beam  element 

OFFSETAY 

Real 

OFFSETAZ 

Real 

OFFSETBX 

Real 

OFFSETBY 

Real 

OFFSETBZ 

Real 

Module  IFP 

1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  BEAMEST  rela¬ 
tion. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CELASl 

Relation 

Contains  the  element  connectivity  data  for  the  scalar  spring  element  as  input  from 
the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  niunber 

PIDl 

Integer  >  0 

Identification  number  of  a  PELAS  property 
entry 

GRIDl 

Integer  >  0 

Grid  or  scalar  point  identification  number 

COMPNTSl 

6  >  Integer  >  0 

Component  number 

GRID2 

Integer  >  0 

Grid  or  scalar  point  identification  number 

COMPNTS2 

6  >  Integer  >  0 

Component  number 

TMAX 

Real 

Maximum  spring  constant  value  for  design 

Module  IFF 

1.  This  relation  is  used  by  the  MAEEST  module  to  build  the  ELASEST  relation. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes : 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


CELAS2 

Relation 

Contains  the  element  connectivity  and  property  data  for  the  scalar  spring  element 
as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

- - - 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

K 

Real 

The  value  of  the  scalar  spring  constant 

GRIDI 

Integer  >  0 

Grid  or  scalar  point  identification  number 

COMPNTSl 

6  >  Integer  >  0 

_  j 

Component  number 

GRID2 

Integer  >  0 

Grid  or  scalar  point  identification  number 

COMPNTS2 

6  >  Integer  >  0 

Component  number 

DMIPCOEF 

Real 

Damping  coefficient 

STRSCOEF 

Real 

Stress  coefficient 

TMIN 

Real 

Minimum  spring  constant  value  for  design 

TMAX 

_ I - 

Real 

Maximum  spring  constant  value  for  design 

Module  IFF 

1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  ELASEST  relation. 


CENTRESP 

Relation 

Contains  the  user  fimction  requested  element  centroidal  coordinate  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  fimction  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value  1 

Module  PFBULK 


473 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CIHEXl 

Relation 

Contains  the  element  connectivity  data  for  the  linear  isoparametric  hexahedron 
element  as  input  from  the  Biilk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

PID 

Integer  >  0 

Identification  number  of  property  card 

GRIDl,  GRID2 

Integer  >  0 

Grid  point  identification  numbers 
defining  the  element  geometry 

GRID3,  GRID4 

Integer  >  0 

GRIDS,  GRIDS 

Integer  >  0 

GRID7,  GRIDS 

Integer  >  0 

Module  IFF 


1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  IHEXIEST  rela¬ 
tion. 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CIHEX2 

Relation 

Contains  the  element  connectivity  data  for  the  quadratic  isoparametric  hexahedron 
element  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

PID 

Integer  >  0 

Identification  number  of  property 
card 

GRIDl,  GRID2 

Integer  >  0 

Grid  point  identification  numbers 
defining  the  element  geometry 

GRIDS,  GRID4 

Integer  >  0 

GRIDS,  GRID6 

Integer  >  0 

GRID7,  GRIDS 

Integer  >  0 

GRIDS,  GRIDIO 

Integer  >  0 

GRIDll,  GRID12 

Integer  >  0 

GRID13,  GRID14 

Integer  >  0 

GRIDl 5,  GRIDl 6 

Integer  >  0 

GRID17,  GRIDl 8 

Integer  >  0 

GRID19,  GRID20 

Integer  >  0 

Module  IFF 

1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  IHEX2EST  rela¬ 
tion. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CIHEX3 

Relation 

Contains  the  element  connectivity  data  for  the  cubic  isoparametric  hexahedron 
element  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

EID 

Integer  >  0,  key 

Element  identification  number 

PID 

Integer  >  0 

Identification  number  of  property 
card 

GRIDl,  GRID2 

Integer  >  0 

Grid  point  identification  numbers 
defining  the  element  geometry 

GRID3,  GRID4 

Integer  >  0 

GRIDS,  GRID6 

Integer  >  0 

GRID7,  GRIDS 

Integer  >  0 

GRID9,  GRIDIO 

Integer  >  0 

GRIDll,  GRID12 

Integer  >  0 

GRID13,  GRID14 

Integer  >  0 

GRID15,  GRID16 

Integer  >  0 

GRID17,  GRID18 

Integer  >  0 

Grid  point  identification  numbers 
defining  the  element  geometry 

GRID19,  GRID20 

Integer  >  0 

GRID21,  GRID22 

Integer  >  0 

GRID23,  GRID24 

Integer  >  0 

GRID25,  GRID26 

Integer  >  0 

GRID27,  GRID28 

Integer  >  0 

GRID29,  GRID30 

Integer  >  0 

GRID31,  GRID32 

Integer  >  0 

Module  IFF 


1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  IHEX3EST  rela¬ 
tion. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CLAMBDA 

Relation 

Contains  results  of  a  flutter  analysis  for  a  series  of  boundary  conditions,  Mach 
numbers  and  atmospheric  densities. 


NAME 

TYPE/KEY 

DESCRIPTION 

NITER 

Integer 

Iteration  number 

BCID 

Integer 

The  boundary  condition  number 

MACH 

Real 

Mach  number  of  the  flutter  analysis 

RHOREF 

Real 

Reference  atmospheric  density 

RHO 

Real 

Atmospheric  density  of  the  flutter  analysis 

VELOCITY 

Real 

True  velocity  of  the  flutter  analysis 

1  FSID 

Integer 

Flutter  set  identification 

1  SCNUM 

Integer 

Flutter  subcase  identification  number 

MODENO 

Integer 

Mode  number  associated  with  the  flutter 

RLAMB 

Real 

Real  part  of  the  flutter  eigenvalue 

I  LAMB 

Real 

Imaginary  part  of  the  flutter  eigenvalue 

DAMPVAL 

Real 

Damping  ratio 

OMEGA 

Real 

Frequency  in  radians  per  second  of  the  flutter  j 
eigenvalue 

=  2  *  VELOCITY  *  ILAMB  /  REFB 

1  PNUM 

Integer 

Pointer  to  CONST  tuple  for  the  associated 
constraint 

Module  FLUTTRAN 

1.  The  reference  semichord  for  the  unsteady  area  model  is  stored  as  the  elev¬ 
enth  word  of  the  INFO  array. 


Entity: 

Entity  l^pe: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CMASSl 

Relation 

Contains  the  element  connectivity  data  for  the  scalar  mass  element  as  input  from 
the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

PIDl 

Integer  >  0 

Property  identification  number  of  a 

PMASS  tuple 

GRIDl 

Integer  >  0 

Grid  or  scalar  point  identification  number 

COMPNTSl 

Integer  >  0 

Component  of  GRIDl  to  which  the  element 
is  connected 

GRID2 

Integer  >  0 

Grid  or  scalar  point  identification  number 

COMPNTS2 

Integer  >  0 

Component  of  GRID2  to  which  the  element 
is  connected 

TMAX 

Real 

Maximum  mass  for  design 

Module  IFF 


1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  MASSEST  rela¬ 
tion. 


Entity; 

Entity  Type: 
Description: 

Relation  Attributes; 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description; 

Relation  Attributes; 


Created  By; 


C]y[ASS2 

Relation 

Contains  the  element  connectivity  data  for  the  scalar  mass  element  as  input  from 
the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

MASS 

Real 

The  value  of  the  scalar  mass 

GRIDl 

Integer  >  0 

Grid  or  scalar  point  identification  number 

COMPNTSl 

Integer  >  0 

Component  of  GRIDl  to  which  the  element 
is  connected 

GRID2 

Integer  >  0 

Grid  or  scalar  point  identification  number 

COMPNTS2 

Integer  >  0 

Component  of  GRID2  to  which  the  element 
is  connected 

TMIN 

Real 

Minimum  mass  for  design 

TMAX 

Real 

Maximum  mass  for  design 

Module  IPP 

1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  MASSEST  rela¬ 
tion. 

CONEFFF 

Relation 

Contains  the  definition  of  adjustment  factors  for  control  surface  effectiveness  values 
for  use  in  flutter  analysis. 


NAME 

TYPE/KEY 

- - - 

DESCRIPTION 

SETID 

Integer  >  0 

Effectiveness  identification  number  1 

EFFVAL 

Real 

Effectiveness  value  1 

MODE 

Integer  >  0 

Structural  mode  to  which  the  effectiveness  is 
to  be  applied  | 

MACROID 

Integer 

aerodynamic  component  (macroelement)  on  1 

which  the  control  surface  lies  I 

BOXl,  BOX2 

Integer  >  0 

First  and  last  box  whose  effectiveness  is  to  be  | 
altered  _ | 

Module  IFP 
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Entity: 

Entity  TVpe: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  IVpe: 
Description: 

Relation  Attributes: 


CONEFFS 

Relation 

Contains  the  definition  of  adjustment  factors  for  control  surface  effectiveness  values 
for  use  in  static  aeroelastic  analysis  and  nonplanar  aerodynamic  analysis. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Effectiveness  identification  niunber 

LABELI 

Ttext  (8) 

Control  surface  label 

EFFI 

Real 

Effectiveness  value  for  the  associated  surface 

Module  IFF 

CONLINK 

Relation 

Contains  the  control  surfaces  and  participation  factors  specified  on  the  CONLINK 
Bulk  Data  entry 


NAME 

TYPE/KEY 

DESCRIPTION 

LABEL 

Tfext  (8) 

Label  of  the  control  surface  that  is  made  up  of 
a  combination  of  other  conatro  surfaces 

LABELI 

Tfext  (8) 

Label  of  control  surface  defined  by  AESURF 

VALUEI 

Real 

Participation  factor  j 

Created  By: 


Module  IFF 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CONMl 

Relation 

Contains  the  element  data  for  a  6  x  6  symmetric  mass  matrix  at  a  grid  point  as  input 
from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

GRIDl 

Integer  >  0 

Grid  point  identification  number 

CIDl 

Integer  >  0 

Coordinate  system  identification 
number  for  matrix  coordinate  system 

Mil,  M21,  M22 

Real 

Elements  of  the  6x6  symmetric  mass 
matrix 

M31,  M32,  M33 

Real 

M41,  M42,  M43 

Real 

M44 

Real 

M51,  M52,  M53 

Real 

M54,  M55 

Real 

M61,  M62,  M63 

Real 

M64,  M65,  M66 

Real 

Module  IFF 

1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  CONMIEST  rela¬ 
tion. 
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Entity: 

Entity  TVpe: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CONMIEST 

Relation 

Contains  the  element  summary  data  for  a  concentrated  mass  defined  in  the  CONMl 
relation. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

SILl 

Integer  >  0 

Internal  grid  point  identification 
number 

CIDMASS 

Integer  >  0 

Coordinate  system  identification 
number  for  matrix  coordinate  system 

Mil,  M21,  M22 

Real 

Elements  of  the  6x6  symmetric  mass 
matrix 

M31,  M32,  M33 

Real 

M41,  M42,  M43 

Real 

M44 

Real 

M51,  M52,  M53 

Real 

M54,  M55 

Real 

M61,  M62,  M63 

Real 

M64,  M65,  M66 

Real 

CORDl 

Integer  >  0 

Coordinate  system  of  SILl 

X,  Y,  Z 

Real 

Basic  coordinates  of  SILl  | 

Module  MAKEST 


1.  This  relation  is  built  firom  the  CONMl  and  grid  relations.  It  contains  one  tu¬ 
ple  for  each  concentrated  mass  element  defined  in  the  CONMl  relation. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


CON112 

Relation 

Contains  the  element  data  for  a  concentrated  mass  at  a  structural  grid  point  as 
input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

GRIDl 

Integer  >  0 

Grid  point  identification  number 

CIDl 

Integer 

Coordinate  system  identification 
number 

MASS 

Real 

Value  of  the  concentrated  mass 

XI,  X2,  X3 

Real 

Components  of  offset  from  GRIDl 
to  the  mass 

Ill,  121,  122 

Real 

Mass  moments  of  inertia 

131,  132,  133 

Real 

TMIN 

Real 

Minimum  mass  for  design 

TMAX 

Real 

Maximum  mass  for  design 

Created  By: 
Notes: 


Module  IFF 

1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  CONM2EST  rela¬ 
tion. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CONiyi2EST 


Relation 

Contains  the  element  summary  data  for  a  concentrated  mass  element  defined  in  the 
CONM2  relation. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

SILl 

Integer  >  0 

Internal  grid  point 
identification  number 

CIDMASS 

Integer  >  0 

Coordinate  system 
identification  nximber 

MASS 

Real 

Mass  value 

OFFSETX 

Real 

Offsets  from  SILl  to  mass  (see 
note  1) 

OFFSETY 

Real 

OFFSETZ 

Real 

Ill,  121,122 

Real 

Mass  moments  of  inertia  (see 
Note  1) 

131,  132,  133 

Real 

COORDl 

Integer  >  0 

Displacement  coordinate 
system  for  SILl 

X,  Y,  Z 

Real 

Basic  coordinates  of  SILl 

DESIGN 

Integer 

Design  flag 

NLFLAG 

Integer  >  0 

Design  variable  nonlinear  flag 
=  0  Linear 
=  1  7y  ^  0 

Module  MAKEST 


1.  Refer  to  the  CONM2  Bulk  Data  Entry  for  further  details  on  the  definition  of 
the  OFFSET  and  lij  terms. 

2.  This  relation  is  built  firom  the  CONM2  grid  relations.  It  contains  one  tuple 
for  each  concentrated  mass  element  defined  in  the  CONM2  relation. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CONROD 

Relation 

Contains  the  connectivity  and  property  data  for  a  ROD  element  as  input  from  the 
Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

GRIDl 

Integer  >  0 

Grid  point  identification  number  for  end  A 

GRID2 

Integer  >  0 

Grid  point  identification  number  for  end  B 

MIDI 

Integer  >  0 

Material  property  identification  number 

AREA 

Real  >  0 

Element  cross-sectional  area 

TORSION 

Real  >  0 

Element  torsional  constant 

STRSCOEF 

Real 

Stress  recovery  factor 

NSM 

Real  >  0 

Element  nonstructural  mass 

TMIN 

Real  >  0 

Minimiun  cross-sectional  area  in  design 

TMAX 

Real  >  0 

Maximum  cross-sectional  area  in  design 

Modiile  IFF 

1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  RODEST  relation. 


Entity: 

Entity  TVpe: 
Description: 
Relation  Attributes: 


CONST 

Relation 

Contains  the  constraint  values  and  constraint  sensitivity  processing  data. 


NAME 

TYPE/KEY 

DESCRIPTION 

NITER 

Integer  >  0 

Iteration  number 

CVAL 

Real 

Constraint  value 

CTYPE 

Integer  >  0 

Constraint  type  (see  Note  2  below) 

BCID 

Integer  >  0 
or  NULL 

Boundary  condition  identification  number  for 
constraint  value  if  boundary  condition 
dependent 

Non-boundary  dependent  constraints  are: 
minimum  thickness  (CTYPE=1) 
maximum  thickness  (CTYPE=2) 
laminate  composition  (CTYPE=13) 
laminate  min.  gauge  (CTYPE=14) 
ply  min.  gauge  (CTYPE=15) 

BAR  dimension  relation  (CTYPE=18) 

DISFLAG 

Integer  >  0 
or  NULL 

Discipline  type  flag  from  CASE  relation  (where 
appropriate) 

Non-discipline  dependent  constraints  are: 
minimum  thickness  (CTYPE=1) 
maximum  thickness  (CTYPE=2) 
laminate  composition  (CTYPE=13) 
laminate  min.  gauge  (CTYPE=14) 
ply  min.  gauge  (CTYPE=15) 

BAR  dimension  relation  (CTYPE=18) 

ACTVFLAG 

Integer  >  0 
or  NULL 

Flag  denoting  status  of  the  constraint  as  active 
(=1)  or  inactive  (=0) 

ACTVFLAG  will  have  NULL  value  prior  to 
constraint  screening  in  ACTCON 

The  entry  with  CLASS  as  OBJECTIVE  has  its 
ACTVFLAG  set  to  be  active 

SCNUM 

Integer  >  0 
or  NULL 

See  Remark  11 

PNUM 

Integer  >  0 
or  NULL 

See  Remark  12 

SUBSCRPT 

Integer  >  0 
or  NULL 

Subscript  ntunber  for  SAERO  discipline 
constraints  of  types  3, 4,  5,  6,  9, 10, 11,  and  12 

DISPCOL 

Integer  >  0 
or  NULL 

Column  number  in  the  matrix  of 
pseudodisplacements/accelerations  for  static 
aeroelastic  constraints  ot  types  9,  10,  and  12 

ETYPE 

Itext  (8)  or 
NULL 

Element  type  used  for  stress/strain  and  1 

thickness  constraints  1 
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Created  By: 
Notes: 


1  NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  or 
NULL 

Element  identification  number 

LAYERNUM 

Integer  or 
NULL 

Element  layer  information  (See  Remark  14) 

DVSYMBL 

'Ifext(8) 

Designed  dimension  symbol 
(Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9,  DIO  for 
BAR  element  cross  section  dimension;  A  for 
element  area,  T  for  element  thickness) 

SCON 

Integer  >  0 
or  NULL 

See  Remark  13 

VSCON 

Real  vector(6) 

Allowables  for  stress/strain  constraints 

BENDPOST 

Integer 

Bending  position  flag  for  nonlinear  sensitivity 

SENSPRMl 

Real 

General  values  useful  for  sensitivity 
calculations  (see  Remark  10) 

SENSPRM2 

Real 

SENSPRM3 

Real 

SENSPRM4 

Tfext(8) 

SENSPRM5 

Real 

vector(lO) 

PRINTKEY 

Integer 

Pointer  to  the  GRADIENT  entity  containing 
the  gradient  of  the  constraint  with  respect  to 
the  global  variables 

=  0  if  no  gradient  was  stored  (see  Remark  15) 

INSTANCE 

Integer 

User  function  instance  number 

CLASS 

Itextiie) 

User  function  class 
(OBJECTIVE/CONSTRAINTS) 

UFNAME 

'Ifext(8) 

User  function  name 

See  Note  below. 


1.  NULL  values  imply  the  value  is  supplied  with  the  database  default  null 
value.  These  are  typically  bit  patterns  which  represent  illegal  values  of  their 
respective  data  types.  See  RENULi  utility  documentation.  For  this  relation, 
zero  is  sometimes  used  in  place  of  the  database  NULL  value. 

2.  The  constraint  t3rpes  are: 

0  =  Objective  function 

1  =  Minimum  thickness  constraint 

2  =  Maximum  thickness  constraint 

3  =  Displacement  constraint 

4  =  Stress  constraint 

5  =  Strain  constraint  on  Ex  principal  strain 

6  =  Strain  constraint  on  Ey  principal  strain 

7  =  Frequency  constraint 

8  =  Flutter  constraint 

9  =  lift  Effectiveness  Constraint 
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10  =  Aileron  Effectiveness  Constraint 

11  =  Trim  Parameter  Limit  Value  Constraint  (DCONTRM) 

12  =  Stability  Derivative  Constraint  (DCONSCF) 

13  =  Laminate  Composition  Constraint  (DCONLAM) 

14  =  Laminate  Minimum  Gauge  Constraint  (DCONLMN) 

15  =  Ply  Minimum  Gauge  Constraint  (DCONPMN) 

16  =  Panel  Buckling  Constraint  (DCONBK) 

17  =  Euler  Buckling  Constraint  (DCONBKE) 

18  =  BAR  Element  Dimemsion  Relation  Constraint(DCONSDE) 

19  =  User  Function  Constraint  (DCONF) 

3.  Constraints  of  1  and  2  are  evaluated  in  the  TCEVAL  module.  The  sen¬ 
sitivities  are  evaluated  in  the  MAKDFV  module. 

4.  Constraints  of  Type  3  are  evaluated  in  the  DCEVAL  module.  The  sensitivi¬ 
ties  are  evaluated  in  the  MAKDFU  module. 

5.  Constraints  of  Type  4,  5  and  6  are  evaluated  in  the  SCEVAL  module.  The 
sensitivities  are  evaluated  in  the  MAKDFU  module. 

6.  Constraints  of  Type  7  are  evaluated  in  the  FCEVAL  module.  The  sensitivities 
are  evaluated  in  the  FREQSENS  module. 

7.  Constraints  of  Type  8  are  evaluated  in  the  FLUTTRAN  module.  The  sensitivi¬ 
ties  are  evaluated  in  the  FLUTSENS  module. 

8.  Constraints  of  Types  9,  10,  11,  and  12  are  evaluated  in  the  SAERO  module. 
The  sensitivities  of  9, 10,  and  12  are  evaluated  in  the  AEROEFFS  and  those 
of  11  in  the  AEROSENS  module. 

9.  Constraints  of  Types  13,  14,  and  15  are  evaluated  in  the  LAMINCON  mod- 
xile.  The  sensitivities  are  evaluated  in  the  LAMINSNS  module. 

Constraints  of  Types  16  and  17  are  evaluated  in  the  modules  PBKLEVAL  and 
EBKLEVAL,  respectively.  The  sensitivities  are  evaluated  in  the  modules 
PBKLSENS  and  EBKLSENS,  respectively. 

Constraints  of  Types  18  are  evaluated  in  the  BCEVAL  module.  The  sensitivi¬ 
ties  are  evaluated  in  the  MKDFDV  module. 

User  function  constraints  (Types  18)  are  evaluated  in  the  FNEVAL  module. 
The  sensitivities  are  evaluated  in  the  DESIGN  module. 

10.  The  SENSPRMl,  2,  3,  4  and  5  attributes  contain  values  useful  in  sensitivity 
analysis  for  certain  constraint  types. 

Type  1  -  SENSPRMl  contains  the  minimum  gauge  used  to  normalize 

the  constraint. 

Type  2  -  SENSPRM2  contains  the  maximum  gauge  used  to  normalize 

the  constraint. 

Type  7  -  SENSPRMl  contains  the  current  value  of  the  associated 

eigenvalue. 

Type  9  -  SENSPRMl  contains  the  current  value  of  the  associated  rigid 

hft  curve  slope.  SENSPRM2  contains  the  value  of  the  associ¬ 
ated  required  ratio. 

Type  10  -  SENSPRMl  contains  the  current  value  of  the  associated  di¬ 
mensional  flexible  rolling  moment  slope  due  to  aileron  deflec¬ 
tion. 

SENSPRM2  contains  the  current  value  of  the  associated  flex¬ 
ible  rolling  moment  slope  due  to  roll  rate. 

SENSPRM3  contains  the  required  roU  effectiveness  and  other 
constants: 
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b  *  180 


SENSPKM3  = 


where 

b  =  reference  span 


aileron  effectiveness 


SENSPRM4  contains  the  name  of  the  rolling  control  surface 
whose  effectiveness  is  constrained. 

Type  11  -  SENSPRMl  contains  the  required  value  of  the  trim  parame¬ 
ter. 

SENSPRM4  contains  the  name  of  the  trim  parameter  whose 
derivative  is  constrained. 

Type  12  -  SENSPRMl  contains  the  required  dimensional  value  of  the 
stability  derivative. 

SENSPRM2  contains  the  real  equivalent  of  the  degree  of  free¬ 
dom  number  (1,  2, ...  or  6)  representing  the  DOF  associated 
with  the  derivative. 

SENSPRM4  contains  the  name  of  the  trim  parameter  or  accel¬ 
eration  whose  derivative  is  constrained. 

Type  13  -  SENSPRMl  contains  the  required  upper  or  lower  bound  per¬ 
centage  of  ply  to  laminate  thickness. 

SENSPRM2  contains  the  current  ply  thickness 
SENSPRM3  contains  the  current  laminate  thickness 
Type  14  -  SENSPRMl  contains  the  minimum  thickness  value. 

SENSPRM3  contjiins  the  current  laminate  thickness 
Type  15  -  SENSPRMl  contains  the  minimum  thickness  value. 

SENSPRM2  contains  the  current  ply  thickness 
Type  17  -  SENSPRM4  contains  the  PBARl  indicator. 

SENSPRM5  contains  the  buckling  sensitivity  information  re¬ 
lated  with  each  BAR  element  cross  section  dimension. 

Type  18  -  SENSPRM5  contains  the  required  cross  section  dimension  fac¬ 
tors. 

11.  The  SCNUM  attribute  contains  general  information  to  allow  computation  of 
the  sensitivities.  These  data  are  the  following: 

Type  1  -  =  0  if  constraint  does  not  appear  on  a  DCONTHE[/2  entry 

=  1  if  it  does  appear  on  DCONTHK/2 
Type  2  -  NULL 

Type  3  -  Subcase  number  of  discipline  generating  the  constraint 

Type  4  -  Subcase  number  of  discipline  generating  the  constraint 

Type  5  -  Subcase  number  of  discipline  generating  the  constraint 

Type  6  -  Subcase  number  of  discipline  generating  the  constraint 

Type  7  -  Mode  number  associated  with  the  constraint 

Type  8  -  Subcase  number  generating  the  constraint 

Type  9  -  Subcase  number  generating  the  constraint 

Type  10  -  Subcase  number  generating  the  constraint 

Type  11  -  Subcase  mxmber  generating  the  constraint 

Type  12  -  Subcase  number  generating  the  constraint 

Type  13  -  NULL 

Type  14  -  NULL 

Type  15  -  NULL 
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IVpe  16  -  Subcase  number  generating  the  constraint 
lype  17  -  Subcase  number  generating  the  constraint 

IVpe  18  -  NULL 

Type  19  -  NULL 

12.  The  PNUM  attribute  contains  general  pointer  information  to  allow  computa¬ 
tion  of  the  sensitivities.  The  pointer  data  are  the  following: 

Type  1  -  PMINT  matrix  column  number  associated  with  the  constraint 

Type  2  -  PMAXT  matrix  column  number  associated  with  the  constraint 

Type  3  -  Displacement  constraint  number  which  points  into  the 

DCENT  entity 

Type  4  -  Row  in  GLBSIG  where  first  stress  component  for  the  element 

is  stored 

Type  5  -  Row  in  GLBSIG  where  first  stress  component  for  the  element 

is  stored 

Type  6  -  Row  in  GLBSIG  where  first  stress  component  for  the  element 

is  stored 

Type  7  -  NULL 

Type  8  -  Count  number  in  a  running  count  of  flutter  roots.  Matches 

the  PNUM  attribute  in  CLAMBDA 
Type  9  -  NULL 

Type  10  -  NULL 

Type  11  -  NULL 

Type  12  -  NULL 

Type  13  -  Defines  the  laminate 

=  0  if  the  lamanate  thickness  comprises  all  layers 
=  LAMSET  id  of  PLYLIST  data  if  the  lamanate 
thickness  comprises  a  subset  of  layers 
Type  14  -  =0 

Type  15  -  =0 

Type  16,17  -  Count  number  matches  the  PNUM  attribute  in  PDLIST 
T^e  18  -  =0 

Type  19  -  =0 

13.  The  SCON  attribute  contains  general  information  to  allow  computation  of 
the  sensitivities.  These  data  are  the  following: 

Type  1  -  NULL 

Type  2  -  NULL 

Type  3  -  DCONDSP/DCID  value 

Type  4  -  =  1  for  Von  Mises  Stress 

=  2  for  Tsai  Wu  Stress 

Type  5  -  =  +3  Principal  strain  constraint  using  tension  allowable 

=  -  3  Principal  strain  constraint  using  compression  allowable 
=  +4  Fiber/transverse  strain  constraint  using  tension  allow¬ 
able 

=  —  4  Fiber/transverse  strain  constraint  using  compression  al¬ 
lowable 

Type  6  -  =  +3  Principal  strain  constraint  using  tension  allowable 

=  —  3  Principal  strain  constraint  using  compression  allowable 
=  +4  Fiber/transverse  strain  constraint  using  tension  allow¬ 
able 

=  —  4  Fiber/transverse  strain  constraint  using  compression  al¬ 
lowable 

Type  7  -  UPPER  (=1)  or  LOWER  (=~1)  bound  flag 
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Type  8- 


A  combined  nximber  noting  the  velocity,  mode  and  subcase 
number  generating  the  constraint  of  the  form: 

xxxyyyzzz 
where 

XXX  =  subcase  number 
yyy  =  mode  number 
zzz  =  velocity  number 

each  are  limited  to  999.  This  value  is  only  useful  in  that  sort¬ 
ing  by  SCON  sorts  the  constraints  by  velocity  within  each 
mode  within  each  subcase. 

Type  9  -  UPPER  (=1)  or  LOWER  (=~1)  bound  flag 

Type  10  -  UPPER  (=1)  or  LOWER  (=-l)  bound  flag 

Type  11  -  UPPER  (=1)  or  LOWER  (=-l)  bound  flag 

Type  12  -  UPPER  (=1)  or  LOWER  (=-l)  bound  flag 

Type  13  -  UPPER  (=1)  or  LOWER  (=-l)  bound  flag 

Type  14  -  =0 

Type  15  -  =0 

lype  16  -  =0 

I^e  17  -  =0 

lype  18  -  =0 

lype  19  -  =0 

14.  The  LAYERNUM  is  NULL  except  for: 

Types  1,  4,  5,  and  6  -contain  the  layer  number  (if  applicable)  or  0 
Types  13,  and  15  -  if  >  0,  contain  the  layer  number  of  the  ply 

if  <  0,  contain  the  PLYLIST  id  of  the  set  of  layers  in  the 

ply 

15.  The  PRINTKEY  is  only  set  if  the  gradient  is  stored.  This  is  done  only  when 
the  requested  objective  and/or  constraint  fradient  is  selected  in  a  print  of 
punch  request. 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


CONSTORD 

Relation 

Contains  the  reorded  constraint  values  and  constraint  sensitivity  processing  data 
for  the  current  design  iteration. 


NAME 

TYPE/KEY 

DESCRIPTION 

NITER 

Integer  >  0 

Iteration  number 

CVAL 

Real 

Constraint  value 

CTYPE 

Integer  >  0 

Constraint  type  (see  Note  2  for  CONST) 

BCID 

Integer  >  0 
or  NULL 

Boundary  condition  identification  number  for 
constraint  value  if  boimdary  condition 
dependent 

Non-boundary  dependent  constraints  are: 
minimum  thickness  (CTYPE=1) 
maximum  thickness  (CTYPE=2) 

DISFLAG 

Integer  >  0 
or  NULL 

Discipline  type  flag  from  CASE  relation  (where 
appropriate) 

Non-discipKne  dependent  constraints  are: 
minimum  thickness  (CTYPE=1) 
maximum  thickness  (CTYPE=2) 
laminate  composition  (CTYPE=13) 
laminate  min.  gauge  (CTYPE=14) 
ply  min.  gauge  (CTYPE=15) 

SCNUM 

Integer  >  0 
or  NULL 

See  Remark  11  for  CONST 

PNUM 

Integer  >  0 
or  NULL 

See  Remark  12  for  CONST 

SUBSCRPT 

Integer  >  0 
or  NULL 

Subscript  number  for  SAERO  discipline 
constraints  of  types  3,  4,  5,  6,  9, 10,  11,  and  12 

SCON 

Integer  >  0 
or  NULL 

See  Remark  13  for  CONST 

SENSPRM4 

Text  (8) 

String  for  sensitivity 

PRINTKEY 

Integer 

Pointer  to  the  GRADIENT  entity  containing 
the  gradient  of  the  constraint  with  respect  to 
the  global  variables 

=  0  if  no  gradient  was  stored  (see  Remark  15 
for  CONST) 

Created  By: 


See  Note  in  preceding  CONST  description. 


Entity; 

Entity  Type; 
Description; 

Relation  Attributes; 


Created  By; 

Notes; 

Entity; 

Entity  Type; 
Description; 
Relation  Attributes; 


Created  By; 


CONVERT 

Relation 

Contains  the  conversion  factors  for  various  physical  quantities  as  input  from  the 
Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

QUANTITY 

Test  (8) 

Character  string  identifying  the  physical 
quantity  v?hose  imits  are  to  be  converted 

FACTOR 

Real 

Conversion  factor  to  be  applied 

Module  IFF 

1.  Refer  to  CONVERT  Bulk  Data  entry  for  the  valid  QUANTITY  values. 

CORDRESP 

Relation 

Contains  the  user  function  requested  grid  point  coordinate  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value 

Module  PFBULK 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CORDIC 

Relation 

Contains  the  coordinate  system  definition  for  a  cylindrical  coordinate  system  as 
input  from  the  Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

CIDl 

Integer  >  0 

Coordinate  system  identification  number 

GRIDl 

Integer  >  0 

The  grid  point  identification  number  which 
locates  the  system  origin 

GRID2 

Integer  >  0 

The  grid  point  identification  number  which 
defines  the  system  z-axis 

GRIDS 

Integer  >  0 

The  grid  point  identification  number  which 
defines  a  point  lying  in  the  system  xz-plane 

Module  IFF 

1.  This  relation  is  used  by  the  MKTMAT  modtile  to  build  the  CSTM  relation. 

CORD2C 

Relation 

Contains  the  coordinate  system  definition  for  a  cylindrical  coordinate  system  as 
input  from  the  Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

CIDl 

Integer  >  0 

Coordinate  system  identification  number 

RID 

Integer  >=0 

Coordinate  system  identification  number  of  I 

system  in  which  the  coordinates  of  the  defining  I 
locations  are  given 

Al,  A2,  A3 

Real 

Coordinates  of  system  origin 

Bl,  B2,  B3 

Real 

Coordinates  defining  z-axis 

Cl,  C2,  C3 

Real 

Coordinates  defining  xz  plane 

Module  IFF 

1.  This  relation  is  used  by  the  MKTMAT  module  to  build  the  CSTM  relation. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CORDIR 

Relation 

Contains  the  coordinate  system  definition  for  a  rectangular  coordinate  system  as 
input  from  the  Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

CIDl 

Integer  >  0 

Coordinate  system  identification  number 

GRIDl 

Integer  >  0 

The  grid  point  identification  number  which 
locates  the  system  origin 

GRID2 

Integer  >  0 

The  grid  point  identification  number  which 
defines  the  system  z-axis 

GRID3 

Integer  >  0 

The  grid  point  identification  number  which 
defines  a  point  lying  in  the  system  xz-plane 

Module  IFF 


1.  This  relation  is  used  by  the  MKTMAT  module  to  build  the  CSTM  relation. 

CORD2R 

Relation 

Contains  the  coordinate  system  definition  for  a  rectangular  coordinate  system  as 
input  from  the  Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

_ _ _ 

CIDl 

Integer  >  0 

1 

Coordinate  system  identification  number 

RID 

Integer  >  0 

Coordinate  system  identification  number  of 
system  in  which  the  coordinates  of  the  defining  | 
locations  are  given  | 

Al,  A2,  A3 

Real 

Coordinates  of  system  origin  | 

Bl,  B2,  B3 

Real 

Coordinates  defining  z-axis 

Cl,  C2,  C3 

Real 

Coordinates  defining  xz-plane 

Module  IFF 

1.  This  relation  is  used  by  the  MKTMAT  module  to  build  the  CSTM  relation. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CORDIS 

Relation 

Contains  the  coordinate  system  definition  for  a  spherical  coordinate  system  as  input 
from  the  Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

CIDl 

Integer  >  0 

Coordinate  system  identification  number 

GRIDl 

Integer  >  0 

The  grid  point  identification  number  which  j 

locates  the  system  origin 

GRID2 

Integer  >  0 

i  The  grid  point  identification  number  which 
defines  the  system  z-axis 

GRIDS 

Integer  >  0 

The  grid  point  identification  number  which 
defines  a  point  l3dng  in  the  system  xz-plane 

Module  IFF 

1.  This  relation  is  used  by  the  MKTMAT  module  to  build  the  CSTM  relation. 

CORD2S 

Relation 

Contains  the  coordinate  system  deiBnition  for  a  spherical  coordinate  system  as  input 
from  the  Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

CIDl 

Integer  >  0 

Coordinate  system  identification  number 

RID 

Integer  >  0 

Coordinate  system  identification  number  of 
system  in  which  the  coordinates  of  the  defining 
locations  are  given 

Al,  A2,  AS 

Real 

Coordinates  of  system  origin 

Bl,  B2,  BS 

Real 

Coordinates  defining  z-axis 

Cl,  C2,  C3 

Real 

Coordinates  defining  xz-plane  | 

Module  IFF 

1.  This  relation  is  used  by  the  MKTMAT  module  to  build  the  CSTM  relation. 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes : 


Created  By: 
Notes: 


CQDMEMl 

Relation 

Contains  the  element  connectivity  data  for  the  linear  isoparametric  quadrilateral 
membrane  element  as  input  from  the  Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION  1 

EID 

Integer  >  0,  key 

Element  identification  number 

PIDl 

Integer  >  0 

Property  identification  number  of  P- 
Type  tuple 

GRIDl,  GRID2 

Integer  >  0 

Grid  point  identification  number 

GRIDS,  GRID4 

Integer  >  0 

CID 

Integer  >  0 

Coordinate  system  used  to  define 
material  axis 

THETA 

Real 

Material  orientation  angle  for 
anisotropic  materials  j 

TMAX 

Reals  0 

Maximun  element  thickness  in  design 

Module  IFF 


1.  The  FID  refers  to  a  FQDMEMl  tuple. 

2.  This  relation  is  used  by  the  MAKEST  module  to  build  the  QDMMIEST  rela- 

3  Note  that  the  relation  contains  two  attributes  CID  and  THETA  to  account  for 
the  dual  definition  of  the  THETA  field  on  the  CQDMEMl  bulk  data  entry. 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CQUAD4 

Relation 

Contains  the  element  connectivity  data  for  the  quadrilateral  bending  element  as 
input  from  the  Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

PIDl 

Integer  >  0 

Property  identification  number  of  P- 
IVpe  tuple 

GRIDl,  GRID2 

Integer  >  0 

Grid  point  identification  number 

GRID3,  GRID4 

Integer  >  0 

CIDl 

Integer  >  0 

Coordinate  system  used  to  define 
material  orientation 

THETA 

Real 

Material  orientation  angle  for 
anisotropic  materials 

OFFSETO 

Real 

Offset  of  element  reference  plane  from 
plane  of  the  grid  point 

TMAX 

Real  >  0 

Maximim  laminate  thickness  in  design 

THICKl 

Real  >  0 

Element  thickness  at  grid  point  GRIDl 

THICK2 

Real  >  0 

Element  thickness  at  grid  point  GRID2 

THICKS 

Real  >  0 

Element  thickness  at  grid  point  GRIDS 

THICK4 

Real  >  0 

Element  thickness  at  grid  point  GRID4 

Module  IFF 


1.  The  FID  may  refer  to  a  FCOMFi  or  FSHELL  tuple. 

2.  This  relation  is  used  by  the  MAKEST  module  to  build  the  QUAD4EST  rela¬ 
tion. 

3.  Note  that  the  relation  contains  two  attributes  CID  and  THETA  to  account  for 
the  dual  definition  of  the  THETA  field  on  the  CQUAD4  bulk  data  entry. 
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Entity: 

Entity  lype: 
Description: 

Relation  Attributes : 


Created  By: 

Notes: 

Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CROD 

Relation 

Contains  the  element  connectivity  data  for  the  ROD  element  as  input  from  the  Bulk 
Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

PIDl 

Integer  >  0 

Froperty  identification  number  of  a  FROD 
tuple  1 

GRIDl 

Integer  >  0 

Grid  point  identification  number  defining 
end  A  I 

GRID2 

Integer  >  0 

Grid  point  identification  niunber  defining 
end  B 

TMAX 

Real  >  0 

Maximum  cross-sectional  area  in  design 

Module  IFF 

1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  RODEST  relation. 


CSHEAR 

Relation 

Contains  the  connectivity  data  for  the  shear  panel  as  input  from  the  Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

PIDl 

Integer  >  0 

Property  identification  number  of  a 
PSHEAR  tuple 

I  GRIDl,  GRID2 

Integer  >  0 

Grid  point  identification  numbers 
defining  the  element  geometry 
_ _ _ — - - - 

1  GRIDS,  GRID4 

Integer  >  0 

1  TMAX 

Real  >  0 

Maximum  thickness  in  design  | 

Module  IFF 

1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  SHEAREST  rela¬ 
tion. 
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Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CSTM 

Relation 

Contains  the  coordinate  transformation  matrices  for  all  external  coordinate  sys¬ 
tems. 


NAME 

Type/KEY 

DESCRIPTION  1 

CID 

Integer  >  0,  key 

Unique  coordinate  system 
identification  number 

CORDTYPE 

Integer  >  0 

The  type  of  coordinate  system 

XO,  YO  ,Z0 

Real 

Basic  coordinates  of  the  system 
origin 

Til,  T21,  T31 

Real 

Elements  of  the  3x3  orthogonal 
transformation  matrix  in  column 
order 

T12,  T22,  T32 

Real 

T13,  T23,  T33 

Real 

Module  MKTMAT 

1.  This  relation  contains  one  tuple  for  each  external  coordinate  system  in  the 
problem. 

2.  The  CORDTYPE  attribute  contains  a  value  of: 

1  =  if  the  system  is  rectangular 

2  =  if  the  system  is  cylindrical 

3  =  if  the  system  is  spherical 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


CTRIA3 

Relation 

Contains  the  connectivity  data  for  the  triangular  shell  element  as  input  from  the 
Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

PIDl 

Integer  >  0 

Property  tuple  identification 
number 

GRIDl,  GRID2 

Integer  >  0 

Grid  point  identification  numbers 
defining  the  element  geometry 

GRID3 

Integer  >  0 

CIDl 

Integer 

Coordinate  system  used  to  define 
the  material  orientation 

THETA 

Real 

Material  orientation  angle  for 
anisotropic  materials 

OFFSETO 

Real 

Offset  of  element  reference  plane 
from  plane  of  the  grid  point 

TMAX 

Real  >  0 

Maximtim  laminate  thicknesses  at 
each  grid  point 

THICKl 

Real  >  0 

Element  thicknesses  at  each  grid 
point 

THICK2 

Real  >  0 

THICKS 

Real  >  0 

Module  IFF 


1.  The  FID  may  refer  to  a  FCOMFi  or  FSHELL  tuple. 

2.  This  relation  is  used  by  the  MAKEST  module  to  build  the  TRIA3EST  rela¬ 
tion. 

3.  Note  that  the  relation  contains  two  attributes  CID  and  THETA  in  order  to  ac¬ 
count  for  the  dual  definition  of  the  THETA  field  on  the  CTRIA3  Bulk  Data  en¬ 
try. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 

Entity: 
Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


CTRMEM 

Relation 

Contains  the  connectivity  data  for  the  constant  strain  triangular  membrane  element 
as  input  from  the  Bulk  Data  file. 


NAME 

Type/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

PIDl 

Integer  >  0 

Property  identification  number  of  a 
PTRMEM  tuple 

GRIDl 

Integer  >  0 

Grid  identification  numbers  defining  the 
geometry 

GRID2 

Integer  >  0 

GRID3 

Integer  >  0 

CID 

Integer  >  0 

Coordinate  system  used  to  define  the 
material  axis 

THETA 

Real 

Material  orientation  angle  for  anisotropic 
materials 

TMAX 

Real  >  0 

Maximum  thickness  in  design 

Module  IFF 

1.  This  relation  is  used  by  the  MAKEST  module  to  build  the  TRMEMEST  rela¬ 
tion. 

2.  Note  that  the  relation  has  two  attributes  CID  and  THETA  to  account  for  the 
dual  definition  of  the  THETA  field  on  the  CTRMEM  bulk  data  entry. 

D 

Subscripted  Matrix 

Contains  the  rigid  body  transformation  matrix  relating  the  displacements  of  the 

solution  set  to  those  of  the  support  set. 

A  variable  sized  design  invariant  matrix  having  one  column  for  each  degree  of 

freedom  in  the  support  set  and  one  row  for  each  degree  of  freedom  in  the  solution 

set  for  the  current  boimdary  condition. 

MAPOL 

1.  This  matrix  is  design  invariant  and  is,  therefore,  computed  only  once  for  each 
unrestrained  boundary  condition. 
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Entity: 
Entity  TVpe: 
Description: 
Record: 


Notes: 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


DCENT 

Unstructured 

Contains  collected  displacement  constraint  information. 

1.  ID’s  of  the  NDSET  displacement  constraint  sets. 

i.  Contains  data  for  the  (i-l)th  constraint  set.  The  information  on  each  of  these 
record  is: 


WORD  # 

VARIABLE 

DESCRIPTION 

1 

SETID 

From  DCONDSP 

2 

NDCID 

Number  of  constraints  in  this  set 

j 

DCID 

Displacement  constraint  ID 

j+1 

CTYPE 

Constraint  t3^e  (see  Remark  4) 

j+2 

ALLOWD 

Allowable 

j+3 

NTERMS 

Number  of  terms  in  the  constraint 

k 

INTID 

Internal  ID  of  constraint  component 

k+1 

AJ 

Factor  on  component 

1 .  There  are  NTERMS  nested  blocks  of  k  data  for  each  block  of  j  data. 

2.  There  are  NDCID  nested  blocks  of  j  data  for  each  record. 

3.  There  are  NSET+1  records  in  the  entity. 

4.  The  constraint  type  is  either  UPPER  bound  (CTYPE=1)  or  LOWER  bound 
(CTYPE=-1). 

DCONALE 

Relation 

Contains  the  roll  effectiveness  constraint  definition  as  input  firom  the  Bulk  Data 
file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Aerodynamic  set  identification  of  the  imposed 
constraint 

LABEL 

Ifext  (8) 

Control  surface  label 

CTYPE 

Text  (8) 

Constraint  type,  either  UPPER  or  LOWER 

AEREQ 

Real 

The  required  roll  effectiveness 

Created  By: 


Module  IFP 


DCONBK 


Entity: 

Entity  IVpe: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


Relation 

Contains  the  local  panel  buckling  constraint  definition  as  input  from  the  Biilk  Data 
file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer 

Plate  panel  buckling  constraiint  set 
identification 

ETYPE 

Tbxt(8) 

Element  type  (QUAD4,  TRIA3) 

EID 

Integer  >  0 

Element  identification  number 

LENGTH 

Real  >  0.0 

Plate  buckling  panel  length 

WIDTH 

Real  >  0.0 

Plate  buckling  panel  width 

CTYPE 

Ttext  (8) 

Constraint  type,  either  UPPER  or  LOWER 

LAMREQ 

Real 

Buckling  eigenvalue  limit 

Module  IFF 

DCONBKE 

Relation 

Contains  the  Euler  buckling  constraint  definition  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

SID 

Integer 

Plate  panel  buckling  constraint  set 
identification 

ETYPE 

Tfext(8) 

Element  type  (BAR,  ROD) 

EID 

Integer  >  0 

Element  identification  number 

LENGTH 

Real  >  0.0 

Rod  buckling  length 

BC 

Text(8) 

Boundary  conditions  for  control  element 

CTYPE 

Text  (8) 

Constraint  type,  either  UPPER  or  LOWER 

LAMREQ 

Real 

Buckling  eigenvalue  limit 

RSQR 

ALPHA 

Real 

Inertia  linking  parameters  for  ROD 

Module  IFF 
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Module  IFPEntity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  I^pe: 
Description: 
Relation  Attributes: 


Created  By: 


DCONCLA 

Relation 

Contains  the  flexible  lift  curve  slope  constraint  definition  as  input  from  the  Bulk 
Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer 

Aerodynamic  set  identification  of  the  imposed 
constraint 

CTYPE 

Ifext  (8) 

Constraint  type,  either  UPPER  or  LOWER 

CLAREQ 

Real 

The  required  flexible  hft  curve  slope  ratio 

Module  IFF 

DCONDSP 

Relation 

Contains  the  design  displacement  constraint  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

SETID 

Integer  >  0 

Constraint  set  identification  number 

DCID 

Integer  >  0 

Constraint  identification  number 

CTYPE 

Text  (8) 

Constraint  type,  either  UPPER  or 
LOWER 

ALLOWD 

Read 

Allowable  displacement 

LABEL 

Text  (8) 

User  defined  label 

GRIDI 

Integer  >  0 

Grid  point  id  to  which  constraint  is 
applied 

COMPNTI 

Integer  1,2, 3, 4, 5  or  6 

Component  of  GRIDI 

AJ 

Real 

Constraint  coefficient 

Module  IFF 
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Entity: 

Entity  l^pe: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


DCONEP 

Relation 

Contains  the  principle  strain  constraint  definition  by  specifying  the  identification 
numbers  of  constrained  elements. 


NAME 

TYPE/KEY 

— 

DESCRIPTION 

SETID 

Integer  >  0 

Strain  constraint  set  identification  number 

ST 

Real 

Principle  strain  limit  in  tension 

SC 

Real 

Principle  strain  limit  in  compression 

SS 

Real 

Principle  strain  limit  in  shear 

ETYPE 

Ifext  (8) 

Element  type 

LAYRMJM 

Integer 

Layer  number  of  a  composite  element 

EID 

Integer  >  0 

Element  identification  number 

Module  IFF 

DCONEPM 

Relation 

Contains  the  principle  strain  constraint  definition  by  specifying  the  material  iden¬ 
tification  numbers. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Strain  constraint  set  identification  number 

ST 

Real 

Frinciple  strain  hmit  in  tension 

SC 

Real 

Frinciple  strain  limit  in  compression 

SS 

Real 

Frinciple  strain  limit  in  shear 

MID 

Integer  >  0 

Material  identification  number 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By; 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


DCONEPP 

Relation 

Contains  the  principle  strain  constraint  definition  by  specifying  the  element  prop¬ 
erty  identification  numbers 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Strain  constraint  set  identification  number 

ST 

Real 

Principle  strain  limit  in  tension 

SC 

Real 

Principle  strain  limit  in  compression 

SS 

Real 

Principle  strain  limit  in  shear 

PTYPE 

Tfext(8) 

Property  type 

LAYRNUM 

Integer 

Layer  number  of  a  composite  element 

PID 

Integer  >  0 

Property  identification  niimber 

Module  IFP 

DCONF 

Relation 

Contains  the  definition  of  the  synthetic  response  constraints  or  a  synthetic  objective 
function  as  input  from  the  Bulk  Data  file. 


1  NAME 

TYPE/KEY 

DESCRIPTION  1 

SETID 

Integer  >  0 

Set  identification  number  1 

LABEL 

Text(8) 

User  defined  label  for  the  design  function 

FNAME 

'Itext(8) 

Name  of  the  function  defined  in  Functions  j 

packet  1 

ARGLABEL 

'Ifext(8) 

Name  of  the  argument  defined  in  functions  j 

packet  1 

INTARG 

Integer  >  0 

Integer  value  of  the  argument 

RELARG 

Real  >  0.0 

Real  value  of  the  argument 

Module  IFP 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


DCONFLT 

Relation 

Contains  the  definition  of  the  flutter  constraint  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

GFACT 

Real  >  0.0 

Constraint  definition  scaling  factor 

VTYPE 

TtextCS) 

Ifext  string  identifying  the  velocity  type  for  the 
table 

=  TRUE  for  true  velocities 
=  EQUIV  for  equivalent  velocities 

VI 

Real  >  0.0 

Velocity  value 

GAMAI 

Real 

Damping  value 

Module  IFF 

1.  The  relation  contains  one  tuple  for  each  velocity,  damping  pair  given  in  the 
Bulk  Data. 
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Entity: 

Entity  TVpe: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


DCONFRQ 

Relation 

Contains  the  frequency  constraint  definition  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

_ _ _ _ 

SETID 

Integer  >  0 

Aerodynamic  set  identification  of  the  imposed 
constraint 

MODE 

Integer  >  0 

Mode  number  of  the  frequency  to  be 
constrained 

CTYPE 

Tfext  (8) 

Constraint  type  either  UPPER  or  LOWER 

FRQALL 

Real  >  0.0 

The  frequency  constraint  value 

Module  IFF 


DCONFT 

Relation 

Contains  the  fiber/transverse  strain  constraint  definition  by  specifying  the  identi¬ 
fication  numbers  of  constrained  elements. 


NAME 

TYPE/KEY 

DESCRIPTION 

1  SETID 

Integer  >  0 

Strain  constraint  set  identification  number 

EFT 

Real  >  0.0 

Tensile  strain  limit  in  the  fiber  direction 

EFC 

Real 

Compressive  strain  limit  in  the  fiber 
direction 

ETT 

Real  >  0.0 

Tensile  strain  limit  in  the  transverse 
direction 

ETC 

Real 

Compressive  strain  limit  in  the  transverse 
direction 

1  ETYPE 

Tfext(8) 

Element  type 

1  LAYRNUM 

Integer 

Layer  number  of  a  composite  element 

1 

Integer  >  0 

Element  identification  number 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 


DCONFTM 

Relation 

Contains  the  fiber/transverse  strain  constraint  definition  by  specifying  the  material 
identification  numbers. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Strain  constraint  set  identification  number 

EFT 

Real  >  0.0 

Ifensile  strain  limit  in  the  fiber  direction 

EFC 

Real 

Compressive  strain  limit  in  the  fiber 
direction 

ETT 

Real  >  0.0 

Tfensile  strain  limit  in  the  transverse 
direction 

ETC 

Real 

Compressive  strain  limit  in  in  the  | 

transverse  direction  j 

MID 

Integer  >  0 

Material  identification  number 

Module  IFF 

DCONFTP 

Relation 

Contains  the  fiber/transverse  strain  constraint  definition  by  specifying  the  element 
property  identification  numbers. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Strain  constraint  set  identification  number 

EFT 

Real  >  0.0 

Tensile  strain  limit  in  the  fiber  direction 

EFC 

Real 

Compressive  strain  limit  in  the  fiber 
direction 

ETT 

Real  >  0.0 

Tensile  strain  limit  in  the  transverse 
direction 

ETC 

Real 

Compressive  strain  limit  in  in  the 
transverse  direction 

PTYPE. 

Text(8) 

Froperty  t5^e 

LAYRNUM 

Integer 

’  Layer  number  of  a  composite  element 

PID 

Integer  >  0 

Froperty  identification  number  j 

Module  IFF 
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Entity: 

Entity  TVpe: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


DCONLAM 

Relation 

Contains  the  laminate  composition  constraints  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

CTYPE 

Tfext  (8) 

Constraint  type,  either  UPPER  or 
LOWER 

PERCENT 

Real 

Percent  allowable  ply  thickness 

PLYNUM 

Integer  >  0  or  -1 

Ply  number  or  -1  if  PLYSET  is  used 

PLYSET 

Integer  >  0  or  -1 

PLYLIST  identification  number  or  -1  if 
PLYNUM  is  used 

LAMCHAR 

Tfext  (8) 

The  string  ALL  or  blank  if  LAMSET  is 
used 

LAMSET 

Integer  =  0 

PLYLIST  identification  niunber  or  0  if 
LAMCHAR=ALL 

SID 

Integer  >  0 

ELEMLIST  set  identification  number 

Module  IFF 


DCONLIST 

Relation 

Contains  the  defimtion  of  the  constraint  lists  as  input  from  the  Bulk  Data  file. 


1 

NAME 

TYPE/KEY 

DESCRIPTION  1 

SETID 

Integer  >  0 

Set  identification  number  1 

CTYPE 

Text  (8) 

Constraint  type  identifier  1 

NRFAC 

Real 

Retention  factor  for  minimTim  number  of  | 
constraints  1 

EPS 

Real 

Lower  bound  value  for  constraint  selection  | 
by  value  | 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


DCONLMN 


Relation 

Contains  the  laminate  mirdmum  gauge  constraints  as  input  from  the  Bulk  Data 
file. 


NAME 

TYPE/KEY 

DESCRIPTION 

MINTHK 

Real  >  0.0 

Allowable  minimum  gauge 

LAMCHAR 

Tfext  (8) 

The  string  ALL  or  blank  if  LAMSET  is 
used 

LAMSET 

Integer  =  0 

FLYLIST  identification  number  or  0  if 
LAMCHAR=ALL 

SID 

Integer  >  0 

ELEMLIST  set  identification  number 

SIDEONLY 

Integer  =  1  or  NULL 

If  1,  SIDEONLY  indicates  that  this 
constraint  is  redundant  with  a  side 
i  constraint. 

Module  IFF 

DCONPMN 

Relation 

Contains  the  ply  minimum  gauge  constraints  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

MINTHK 

Real  >  0.0 

Allowable  minimum  gauge 

PLYNUM 

Integer  >  0  or  -1 

Fly  number  or  -1  if  FLYSET  is  used 

PLYSET 

Integer  >  0  or  -1 

PLYLIST  identification  number  or  -1  if 
PLYNUM  is  used 

SID 

Integer  >  0 

ELEMLIST  set  identification  number 

SIDEONLY 

Integer  =  1  or  NULL 

If  1,  SIDEONLY  indicates  that  this 
constraint  is  redundant  with  a  side 
*  constraint.  | 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


DCONSCF 

Relation 

Contains  the  definition  of  a  constraint  on  the  flexible  stability  derivative  at  the 
reference  grid  point  associated  with  the  force  or  moment  due  to  a  trim  parameter 
or  control  surface  deflection  of  the  form. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Constraint  set  identification 

ACCLAB 

Text  (8) 

Structural  acceleration  label  j 

PRMLAB 

Text  (8) 

Constrained  control  surface  label  or 
aeroelastic  trim  parameter 

CTYPE 

Tsxt  (8) 

Constraint  type 

PRMREQ 

Real 

Stability  coefficient  bmmds 

UNITS 

Text  (8) 

Stability  coefficient  units 

Module  IFF 

DCONSDE 

Relation 

Contains  the  definition  of  BAR  element  cross-sectional  dimension  side  constraints. 


NAME 

TYPE/KEY 

DESCRIPTION 

TMIN 

Real  >  0.0 

Minimum  cross-sectional  dimension  in 
design 

TMAX 

Real  >  0.0 

Maximum  cross-sectional  dimension  in 
design 

ETYPE 

Text  (8) 

Element  type.  BAR 

DVSYMBL 

Text  (8) 

Cross-section  dimension  symbol 
(Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9  or 
DIO) 

EID 

Integer  >  0 

Element  identification  number 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


DCONSDL 

Relation 

Contains  the  definition  of  BAR  element  cross-sectional  dimension  side  constraints. 


NAME 

TYPE/KEY 

DESCRIPTION 

TMIN 

Real  >  0.0 

Minimum  cross-sectional  dimension  in 
design 

TMAX 

Real  >  0.0 

Maximum  cross-sectional  dimension  in 
design 

DVSYMBL 

Tfext  (8) 

Cross-section  dimension  s5Tnbol 
(Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9  or 
DIO) 

ELID 

Integer  >  0 

Element  identification  number  | 

Module  IFF 

DCONTH2 

Relation 

Contains  the  list  of  layers  of  composite  elements  for  which  thickness  constraints  are 
always  to  be  retained  in  optimization  with  shape  function  design  variable  linking 
as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

ETYPE 

Ifext  (8) 

Element  type.  One  of  the  following: 

QUAD4  QDMEMl 

TRIAS  TRMEM 

PLYNUM 

Integer  >  0 
or  -1 

Ply  number  or  -1  indicating  PLYSET  is  used 

PLYSET 

Integer  >  0 
or  -1 

FLYLIST  set  identification  or  -1  indicating 
FLYNUM  is  used 

EID 

Integer  >  0 

Element  identification  number 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


DCONTH3 

Relation 

Contains  the  list  of  BAR  element  cross-sectional  dimensions  for  which  side  con¬ 
straints  are  always  to  be  retained  in  optimization  with  shape  function  design 
variable  linking  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

ETYPE 

Tfext  (8) 

Element  t3^e.  BAR 

DVSYMBL 

Tfext  (8) 

Cross-section  dimension  symbol 
(Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9  or 

DIO) 

EID 

Integer  >  0 

Element  identification  number 

Module  IFF 

DCONTHK 

Relation 

Contains  the  list  of  elements  for  which  thickness  constraints  are  always  to  be 
retained  in  optimization  with  shape  function  design  variable  linking  as  input  from 
the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

ETYPE 

Tbxt  (8) 

Element  type.  One  of  the  following: 

BAR  QUAD4 

ELAS  ROD 

MASS  SHEAR 

QDMEMl  TRIAS 

TRMEM 

EID 

Integer  >  0 

Element  identification  number 

Created  By: 


Module  IFF 


Entity: 

Entity  IVpe: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 


DCONTRM 

Relation 

Contains  the  definitions  of  a  trim  parameter  constraint. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Constraint  set  identification 

PRMLAB 

Text  (8) 

Constrained  control  surface  label  or 
aeroelastic  trim  parameter 

CTYPE 

Text  (8) 

Constraint  type 

PRMREQ 

Real 

Trim  parameter  boimd 

Module  IFF 

DCONTW 

Relation 

Contains  the  Tsai-Wu  stress  constraint  definition  by  specifying  the  identification 
numbers  of  constrained  elements. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Stress  constraint  set  identification 

XT 

Real  >  0.0 

Tensile  stress  hmit  in  the  longitudinal 
direction 

XC 

Real 

Compressive  stress  limit  in  the 
longitudinal  direction 

YT 

Real  >  0.0 

Tensile  stress  limit  in  the  transverse 
direction 

YC 

Real 

Compressive  stress  limit  in  the  transverse 
direction 

SS 

Real  >  0.0 

Shear  stress  limit  for  in-plane  stress 

F12 

Real 

Tsai-Wu  interaction  term 

ETYPE 

Text  (8) 

Element  type 

LAYKNUM 

Integer 

Layer  number  of  a  composite  element 

EID 

Integer  >  0 

Element  identification  number 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


DCONTWM 

Relation 

Contains  the  Tbai-Wu  stress  constraint  definition  by  specifying  the  material  identi- 
fication  numbers. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Stress  constraint  set  identification 

XT 

Real  >  0.0 

Tfensile  stress  limit  in  the  longitudinal 
direction 

XC 

Real 

Compressive  stress  limit  in  the 
longitudinal  direction 

YT 

Real  >  0.0 

Tensile  stress  limit  in  the  transverse 
direction 

YC 

Real 

Compressive  stress  limit  in  the  transverse 
direction  | 

SS 

Real  >  0.0 

Shear  stress  limit  for  in-plane  stress  1 

- - - - 

F12 

Real 

Tsai-Wu  interaction  term  I 

MID 

Integer  >  0 

Material  identification  number  | 

Module  IFP 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


DCONTWP 

Relation 

Contains  the  Tsai-Wu  stress  constraint  definition  by  specifying  the  element  property 
identification  numbers. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Stress  constraint  set  identification 

XT 

Real  >  0.0 

Tensile  stress  liniit  in  the  longitudinal 
direction 

XC 

Real 

Compressive  stress  limit  in  the 
longitudinal  direction 

YT 

Real  >  0.0 

Tensile  stress  limit  in  the  transverse 

direction 

YC 

Real 

Compressive  stress  limit  in  the  transverse 
direction 

ss 

Real  >  0.0 

Shear  stress  limit  for  in-plane  stress 

F12 

Real 

Tsai-Wu  interaction  term 

PTYPE 

Text  (8) 

Property  type 

LAYRNUM 

Integer 

Layer  number  of  a  composite  element 

PID 

Integer  >  0 

Property  identification  number 

Module  IFF 
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Entity; 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity; 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


DCONVM 

Relation 

Contains  the  Von-Mises  stress  constraint  definition  by  specifying  the  identification 
numbers  of  constrained  elements. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Stress  constraint  set  identification  number 

ST 

Real 

Stress  limit  in  tension 

SC 

Real 

Stress  limit  in  compression 

1 

Real 

Stress  limit  in  shear 

1  ETYPE 

Tfext  (8) 

Element  type 

LAYRNUM 

Integer 

Layer  number  of  a  composite  element 

EID 

Integer  >  0 

Element  identification  number 

Module  IFF 

DCONVMM 

Relation 

Contains  the  Von-Mises  stress  constraint  definition  by  specifying  the  material 
identification  numbers. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Stress  constraint  set  identification  number 

ST 

Real 

Stress  limit  in  tension 

SC 

Real 

Stress  limit  in  compression 

SS 

Real 

Stress  limit  in  shear 

MID 

Integer  >  0 

Material  identification  number 

Module  IFF 
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DCONVMP 


Entity: 

Entity  TVpe:  Relation 

Description:  Contains  the  Von-Mises  stress  constraint  definition  by  specifying  the  element 

property  identification  numbers. 

Relation  Attributes: 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Stress  constraint  set  identification  number 

ST 

Real 

Stress  limit  in  tension 

SC 

Real 

Stress  limit  in  compression 

SS 

Real 

Stress  limit  in  shear 

PTYPE 

Ibxt  (8) 

Property  type 

LAYRNUM 

Integer 

Layer  number  of  a  composite  element 

PID 

Integer  >  0 

Property  identification  number 

Created  By: 

Module  IFF 

Entity: 

DDELDV 

Entity  lype: 

Matrix 

Description: 

Matrix  of  sensitivities  of  the  trim  angles  to  changes  in  the  design  variables. 

Matrix  Form: 

The  number  of  rows  is  equal  to  the  ntunber  of  trim  parameters  while  the  niunber  of 
columns  is  equal  to  the  number  of  active  flight  conditions  times  the  number  of  design 
variables. 

Created  By: 

Notes: 

Module  AEROSENS 

1. 


2. 


DDELDV  is  needed  only  when  the  design  task  includes  aero  elastic  trim  and 
the  flight  conditions  have  been  determined  to  be  active  by  module  ABOUND. 
DDELDV  is  determined  through  the  solution  of  the  equation: 


[JJHS  ]  [DDELDV  ]  =  [DEES  ] 
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DDMVI 


Entity: 

Entity  Type:  Unstructured 

Description:  Contains  the  nonlinear  finite  difference  mass  design  sensitivity  matrices. 

Entity  Structure: 

Record: 

i.  Contains  all  or  a  portion  of  the  nonlinear  mass  design  sensitivity  matrix  for  a 
given  design  variable. 

Created  By:  Module  NLEMAl 

j^otos* 

1.  Relation  DGMMCT  contains  connectivity  and  MCODE  information  which  de¬ 
fines  how  the  matrices  are  stored. 

2.  The  sensitivity  matrices  are  stored  in  the  same  precision  as  the  MGG  matrix. 


Entity:  DDPGRV 

Entity  Type:  Matrix 

Description:  Contains  the  nonlinear  gravity  load  finite  difference  sensitivities  for  each  gravity 

load  set  referenced  in  solution  control. 

Matrix  Form:  A  variable-sized  matrix  having  one  row  for  each  structural  degree  of  freedom  and 

one  column  for  each  gravity  load  condition  for  each  design  variable  (including  the 
zeroth  design  variable).  The  order  of  the  matrix  columns  is: 

(A)  The  NGRAV  columns  for  each  gravity  load  set  for  the  zeroth  design  vari¬ 
able  in  load  set  id  order. 

(B)  The  NGRAV  columns  for  each  gravity  load  set  for  the  first  design  variable 
in  load  set  id  order,  etc. 

Created  By:  NLLODGEN 

Notes: 

1.  This  matrix  is  empty  if  no  gravity  loads  are  referenced  in  solution  control  or 
in  a  LOAD  Bulk  Data  entry,  or  if  there  are  no  nonlinear  design  variables. 

2.  This  matrix  and  matrix  PPGRVI]  constitute  the  total  gravity  load  sensitivi¬ 
ties. 


521 


DDPTHV 


Entity: 

Entity  Type: 
Description: 

Matrix  Form: 


Created  By: 
Notes: 


Matrix 

Contains  the  nonlinear  thermal  load  finite  difference  sensitivities  for  each  thermal 
load  set  referenced  in  the  solution  control. 

A  variable-sized  matrix  having  one  row  for  each  structoal  degree  of  freedom  and 
one  colunm  for  each  thermal  load  condition  for  each  design  variable  (including  the 
zeroth  design  variable).  The  order  of  the  matrix  columns  is: 

(A)  The  NTHERM  columns  for  each  thermal  load  set  for  the  zeroth  design 
variable  in  load  set  id  order. 

(B)  The  NTHERM  columns  for  each  thermal  load  set  for  the  first  design  vari¬ 
able  in  load  set  id  order,  etc. 

Module  NLLODGEN 

1.  This  matrix  is  empty  if  no  thermal  loads  are  referenced  in  solution  control,  or 
if  there  are  no  nonlinear  design  variables. 

2.  This  matrix  and  matrix  [DPTHVT]  constitute  the  total  thermal  load  sensitivi¬ 
ties. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


DDVCT 

Relation 

Contains  the  data  required  for  the  assembly  of  the  nonlinear  portion  (in  finite 
difference  form)  of  design  sensitivity  matrices.  This  relation  is  sorted  first  by  DVID 
and  then  by  KSIL. 


1  NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  identification  number 

PREF 

Real 

Design  variable  linking  factor 

ALPHA 

Real 

Exponential  power  associated  with  the  design 
variable 

KSIL 

Integer  >  0 

Internal  identification  for  a  grid  connected  to 
the  element 

KCODE 

Integer  >  0 

A  code  word  denoting  the  form  in  which  the 
element  stiffiaess  matrix  is  stored 

MCODE 

Integer  >  0 

A  code  word  denoting  the  form  in  which  the 
element  mass  matrix  is  stored 

TCODE 

Integer  >  0 

A  code  word  denoting  the  form  in  which  the 
element  thermal  loads  sensitivities  are  stored 

TREFPT 

Integer 

The  position  in  TREF  for  the  associated 
reference  temperature 

NODES 

Integer  >  0 

The  number  of  nodes  connected  to  the  element 

IREC 

Integer  >  0 

The  record  number  of  the  unstructured  entity  I 
KELM,  MELM,  or  TELM  that  contains  the 
partition  of  the  element  matrix 

ASILS 

Ivector  (4) 

List  of  associated  sils  of  the  element  in  sorted  | 
order  1 

Created  By: 


Module  NLEMG 


Notes: 


Entity: 

Entity  Type: 
Description: 
Entity  Structure: 


Created  By: 
Notes: 


1.  This  relation  contains  one  tuple  for  each  nonlinear  design  variable  for  each 
node  of  each  structural  element. 

2.  The  code  words  KCODE,  MCODE  and  TCODE  have  the  following  definition: 


KCODE/MCODETTCODE 

MEANING 

7 

Element  has  extensional  DOF’s  only 

8 

Element  has  rotational  DOF’s  only 

9 

Element  has  both  extension  and  rotation 

10 

Element  matrix  has  only  diagonal  extensional  entries 

11 

Element  matrix  has  only  diagonal  rotational  entries 

12 

Element  matrix  has  diagonal  entries  for  all  grid  point 
DOFs 

3.  A  KCODE,  MCODE  or  TCODE  of  zero  implies  that  the  element  has  no  associ¬ 
ated  stiffiiess,  mass  or  thermal  load. 

4.  Design  variable  offset  value  is  stored  in  INFO(ll)  from  NLEMG.  It  is  used 
for  the  pseudo  design  variable  spawned  to  handle  the  non-linear  portion  of 
the  BAR  element  stiffiiess. 

5.  7,  8,  and  9  are  the  only  values  supported  for  TCODE. 

6.  This  relation  contains  no  tuples  for  linear  design  variables. 

DDVSIZE 

Unstructured 

Contains  memory  allocation  information  on  the  DDVCT  relation. 


Record  1. 


WORD  1 

Maximum  number  of  DDVCT  tuples  associated  with 
any  one  design  variable  other  than  zero 

WORD  2 

Number  of  tuples  connected  to  "design  variable"  zero 

WORD  3  through 
NDV+2 

Number  of  tuples  connected  to  each  design  variable 

Module  NLEMG 

1.  Entity  contains  one  record  with  NDV  +2  words. 
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Entity: 

Entity  Type: 
Description: 

Matrix  Form: 
Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 
Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


DELB 

Matrix 

Matrix  containing  trim  parameters  used  as  initial  conditions  in  the  nuclear  blast 
response  calculations. 

Real  matrix  with  three  rows  and  one  column. 

MAPOL 

DELM 

Matrix 

Matrix  containing  trim  that  precedes  a  nuclear  blast  response  calculation. 
Rectangular  matrix  with  two  rows  and  three  columns. 

MAPOL 

DELTA 

Subscripted  Matrix 

A  vector  of  trim  parameters  for  each  flight  condition. 

The  number  of  rows  is  dependent  on  the  type  of  trim  analysis  being  performed.  The 
number  of  columns  is  equal  to  the  number  of  load  conditions  being  apphed  for  the 
current  Mach  ntunber  and  boundary  condition. 

Module  SAERO 

1.  For  symmetric  analyses,  there  are  two  to  four  rows  in  DELTA,  depending  on 
the  value  of  TRMTYP  on  the  TRIM  Bulk  Data  entry. 

DENSLIST 

Relation 

Contains  the  list  of  density  values  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

1  SID 

Integer 

Set  identification  number 

DENSITY 

Real  >  0.0 

Density  value 

Created  By: 


Module  IFP. 


Entity: 

Entity  lype: 
Description: 

Relation  Attributes : 


Created  By: 
Notes: 


DESELM 


Relation 

Contains  design  variable  connection  information  uniquely  associating  one  design 
variable  to  one  element. 


NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  id  | 

EIDl 

Integer  >  0 

Element  identification  | 

ETYPEl 

TfextCS) 

Element  type  | 

VMIN 

Real 

Minimum  value  of  design  variable 

VMAX 

Real 

Maximum  value  of  design  variable  | 

VALUE 

Real 

Initial  value  of  design  variable 

LAYERNUM 

Integer 

Layer  of  a  composite  material 

DVSYMBL 

lfext(8) 

Designed  dimension  symbol 
(Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9,  DIO  for 
BAR  element  cross  section  dimension;  A  for 
element  area,  T  for  element  thickness;  M  for 
element  mass;  K  for  element  stiffiiess.)  I 

LABEL 

Tfext  (8) 

User  label 

Module  IFF 


1.  The  LAYERNUM  entry  identifies  the  layer  on  the  PCOMP  entry  for  the  ele¬ 
ment  defined  by  EIDl  and  ETYPEl. 
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Entity: 

Entity  T^pe: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


DESHIST 

Relation 

Contains  information  on  the  results  of  major  iterations  in  the  design  task. 


NAME 

TYPE/KEY 

DESCRIPTION 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

OBJEXACT 

Real 

Exact  objective  function  value 

OBJAPROX 

Real 

Approximate  objective  function  value  after  the 
NITERth  approximate  problem  has  been  solved. 

NFUNC 

Integer  >  0 

Number  of  function  evaluations  in  the  current 
iteration 

NGRAD 

Integers  0 

Number  of  gradient  evaluations  in  the  current 
iterations 

NCON 

Integers  0 

Number  of  constraints 

NAC 

Integers  0 

Number  of  active  constraints 

NVC 

Integers  0 

Number  of  violated  constraints 

NLBS 

Integers  0 

Number  of  active  lower  bound  side  constraints 

NUBS 

Integers  0 

Number  of  active  upper  bound  side  constraints 

CONVRGD 

Integers  0 

Convergence  flag 

Module  DESIGN 

1.  The  CONVRGD  parameter  has  the  following  definition: 
CONVRGD  MEANING 

0  Design  has  not  converged 

1  Design  has  converged 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


DESLINK 

Relation 

Contains  design  variable  linking  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

Tfext  (8) 

Element  t5T)e.  One  of  the  following: 

BAR  QDMEMl 

ELAS  QUAD4 

ROD  SHEAR 

TRIAS  TRMEM 

LAYRMJM 

Integer  =  0 

Layer  number,  =  0  if  noncomposite  element 

DVSYMBL 

Tfext(8) 

Designed  dimension  symbol 
(Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9,  DIO  for 
BAR  element  cross  section  dimension;  A  for 
element  area,  T  for  element  thickness;  M  for 
element  mass;  K  for  element  stiffiiess.) 

DVID 

Integer  >  0 

Global  design  variable  connected  to  this 
EID/LAYER 

PREF 

Real 

Design  Variable  Linking  Factor  (  [PTRANS] 
matrix  term) 

MAKEST 

1.  There  is  one  entry  for  each  local  design  variable  for  each  global  design  vari¬ 
able  linked  to  it.  Basically,  this  is  a  relational  form  of  the  [PTRANS]  matrix. 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


DESVARP 

Relation 

Contains  the  properties  of  each  physically  linked  design  variable. 


NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  id 

LINKID 

Integer  >  0 

ELIST  or  PLIST  identification  number 

1  VMIN 

Real 

Minimum  value  of  the  design  variable 

VMAX 

Real 

Maximum  value  of  the  design  variable 

VALUE 

Real 

Initial  value  of  the  design  variable 

LAYERMJM 

Integer 

Layer  number  for  a  composite  element 

LAYRLST 

Integer 

PLYLIST  identification  number  for  layer  list 

LABEL 

Text  (8) 

User  label  to  describe  the  design 

Module  IFF 


1.  The  LAYERNUM  entry  identifies  the  single  ply  of  a  composite  element.  LAY- 
ERNUM  =  -1  if  LAYRLST  is  used. 

2.  The  LAYRLST  entry  identifies  the  list  of  plies  linked  to  the  design  variable. 
LAYRLST  =  -1  if  LAYRNUM  is  used. 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


DESVARS 

Relation 

Contains  the  properties  of  shape  function  linked  design  variable. 


NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  id 

SHAPEID 

Integer  >  0 

SHAPE  set  identification  number 

VMIN 

Real 

Minimum  value  of  the  design  variable 

VMAX 

Real 

Maximum  value  of  the  design  variable 

VALUE 

Real 

Initial  value  of  the  design  variable 

LAYERNUM 

Integer 

Layer  number  for  a  composite  element 

LAYRLST 

Integer 

PLYLIST  identification  number  for  layer  list 

LABEL 

Ifext  (8) 

User  label 

Module  IFF 


1.  The  LAYERNUM  entry  identifies  the  single  ply  of  a  composite  element.  LAY- 
ERNUM  =  -1  if  LAYRLST  is  used. 

2.  The  LAYRLST  entry  identifies  the  list  of  plies  linked  to  the  design  variable. 
LAYRLST  =  -1  if  LAYRNUM  is  used. 
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Entity: 

Entity  Type; 
Description; 
Matrix  Form: 


Created  By: 
Notes: 


DFDU 

Matrix 
See  Notes. 

A  variable  sized  matrix  having  one  row  for  each  structural  degree  of  freedom  and 
one  column  for  each  currently  active  constraint. 

The  order  of  the  DFDU  columns  is  as  follows  for  each  active  boimdary  condition: 

(A)  The  sensitivities  of  active  displacement  constraints  for  each  active  load 
condition. 

(B)  The  sensitivities  of  each  active  stress  or  strain  constraint  in  each  active 
load  condition. 

Module  MAKDFU  or  MAPOL 


1.  For  the  Gradient  Method,  contains  the  sensitivities  of  the  currently  active 
constraints  to  the  global  displacements  for  those  constraints  that  are  func¬ 
tions  of  the  displacements. 

2.  For  the  Virtual  Load  Method,  contains  the  sum  of  the  sensitivity  of  the  de¬ 
sign  dependent  loads  and  the  product  of  the  design  sensitivity  stifihess  ma¬ 
trix  and  the  active  displacement  vectors. 

3.  The  MAPOL  sequence  supports  the  following  partitions  of  the  DFPU  matrix 
(see  Theoretical  Manual  for  the  explicity  formation  of  these  submatrices): 


DFDU 


DFDUN 


DFDDN 


<P 

DFDUF 


Entity: 

DFDUF 

Entity  Type: 

Matrix 

Description: 

A  partition  of  matrix  DFDUN  (see  DFDU). 

Entity: 

DFDU 

Entity  Type: 

Matrix 

Description: 

A  partition  of  matrix  DFDUN  (see  DFDU). 
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DFSV 


Entity: 

Entity  TVpe:  Matrix 

Description:  Contains  design  variable  nonlinear  S-matrix  derivatives  related  active  stress/strain 

constraint  sensitivity  terms. 

Matrix  Form:  A  variable  sized  matrix  having  one  row  for  each  active  subcase  for  each  design 

variable  and  one  column  for  each  currently  active  constraint. 

The  order  of  the  DFSV  columns  is  as  follows  for  each  active  boundary  condition: 

(A)  Null  columns  corresponding  to  the  sensitivities  of  active  displacement  con¬ 
straints  for  each  active  load  condition. 

(B)  The  sensitivities  of  each  active  stress  and/or  strain  constraint  in  each  ac¬ 
tive  load  condition. 

Created  By:  Module  MKDFSV 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


DGMMCT 

Relation 

Contains  data  required  to  interpret  the  DDMVI  unstructured  entity  for  the  purpose 
of  generating  all  of  the  mass  stifl&iess  matrix  partitions.  The  relation  is  sorted  by 
DVID  and  KSIL. 


NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  identification 

KSIL 

Integer  >  0 

Internal  id  of  grid  or  scalar  point 
connected  to  the  design  variable 

MCODE 

Integer  >  0 

Codeword  denoting  the  form  in  which  the 
DDMVI  data  are  stored 

NODES 

Integer  0  <  NODES  < 
20 

Number  of  nodes  being  processed  with 
this  KSIL 

IREC 

Integer  >  0 

Record  number  of  DDMVI  entity  where 
data  are  stored 

ASIL 

Ivector  (20) 

List  of  associated  SILS 

ALPHA 

Real 

Exponential  power  associated  with  BAR  j 
element  design  variable  j 

Module  NLEMAl 


1.  MCODE  definitions: 

=  1  Mxiltiple  associated  grids  with  both  extensional  and  rotational  degrees 
of  freedom. 

=  2  Column  being  assembled  is  a  scalar  point.  Associated  SILS  may  or 
may  not  be  scalar  points. 

=  3  Column  being  assembled  is  a  grid  point.  At  least  one  row  is  a  scalar 
point. 

=  4  Only  extensional  degrees  of  freedom  are  included  in  the  assembly  proc¬ 

ess. 

2.  The  INFO  array  for  this  entity  contains  additional  memory  management  allo¬ 
cation  data: 

INFO(ll)  The  number  of  tuples  connected  to  the  zeroth  design  variable. 

INFO(12)  The  maximum  number  of  tuples  connected  to  any  one  of  the  re¬ 
maining  design  variables. 


Entity: 

Entity  I^pe: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  T^pe: 
Description: 
Relation  Attributes: 


DISPDRVA 

Relation 

Contains  the  user  function  requested  displacement  response  sensitivity  informa¬ 
tion. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

MXCOL 

Integer  >  0 

Matrix  coliunn  number  in  [MXDSPDVA]  for 
the  sensitivity  values 

Module  MKAMAT 

DISPRESP 

Relation 

Contains  the  user  function  requested  displacement  response  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value 

Created  By: 


Module  DCEVAL 


Entity: 

Entity  TVpe: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Entity  Structure: 
Record: 


Created  By: 
Notes: 


DKUG 

Matrix 

The  product  of  the  design  sensitivity  matrices  and  the  active  displacement  vectors. 

The  number  of  columns  is  equal  to  NAC,  the  niimber  of  active  subcases  times  NDV, 
the  number  of  design  variables.  The  number  of  rows  is  equal  to  the  number  of  terms 
in  the  g-set. 

MAKDVU 

1.  The  sensitivity  to  the  first  design  variable  for  all  the  active  subcases  occupies 
the  first  NAC  colmnns.  This  is  followed  by  columns  for  each  of  the  remaining 
design  variables  turn. 

2.  The  negative  of  the  product  is  created  in  order  to  simplify  later  matrix  opera¬ 
tions. 

DKELM 

Unstructured 

Contains  the  element  nonlinear  finite  difference  stiffiiess  sensitivity  matrix  parti¬ 
tions. 


i  the  record  contains  a  partition  of  the  stiffiiess  matrix  with  either  1,  3,  or  6  en¬ 
tries  for  each  node 


KCODE 

FORMAT  OF  RECORD 

7 

3  columns  of  3  entries/node 

8 

3  columns  of  3  entries/node 

9 

6  columns  of  6  entries/node 

Module  NLEMG 

1.  This  entity  contains  one  record  for  each  strip  of  each  element  nonlinear  de¬ 
sign  stiffiiess  derivative  matrix.  A  strip  or  partition  is  defined  as  all  those  col¬ 
umns  of  the  element  matrix  associated  with  a  pivot  sil  (the  ID  of  the  first 
DOF  of  a  grid  point  or  the  id  of  a  scalar  point). 

2.  Refer  to  the  DDVCT  relation  for  further  details,  as  these  two  data  base  enti¬ 
ties  are  closely  linked. 

3.  The  matrix  partitions  are  stored  in  the  same  precision  as  the  KGG  matrix. 

4.  DKELM  and  KELM  are  used  to  generate  all  of  the  element  stiffness  sensitiv¬ 
ity  matrix  partitions. 
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DKVI 


Entity: 

Entity  I^pe: 
Description: 
Entity  Structure: 
Record: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Entity  Structure: 
Record: 


Created  By: 
Notes: 


Unstructured 

Contains  the  stiffiiess  design  sensitivity  matrices. 


1.  Contains  all  of  a  portion  of  the  stif&iess  design  sensitivity  matrix  for  a  given 
design  variable. 

Module  NLEMAl 

1.  Relation  GMKCT  contains  connectivity  and  KCODE  information  which  de¬ 
fines  how  the  matrices  are  stored. 

2.  The  sensitivity  matrices  are  stored  in  the  same  precision  as  the  KGG  matrix. 

3.  DKVI  is  built  from  DKVIO  (which  contains  the  linear  stiffness  design  sensitiv¬ 
ity  matrix)  and  from  the  finite  difference  nonlinear  stiffness  design  sensitivity. 

DKVIO 

Unstructured 

Contains  the  linear  stiffness  design  sensitivity  matrices. 


1.  Contains  all  of  a  portion  of  the  linear  stiffness  design  sensitivity  matrix  for  a 
given  design  variable. 

Module  NLEMAl 


1.  Relation  GMKCTO  contains  connectivity  and  KCODE  information  which  de¬ 
fines  how  the  matrices  are  stored. 

2.  The  sensitivity  matrices  are  stored  in  the  same  precision  as  the  KGG  matrix. 

3.  The  INFO  array  contains  information  on  the  generation  of  the  mass  matrix. 
INFO(ll)  =  1  Generate  the  global  mass  matrix  in  the  final  analysis 

=  0  Don’t  generate  the  global  mass  matrix 
INFO(12)  =  1  Generate  the  global  mass  matrix  for  the  optimization 
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Entity; 

Entity  Type: 
Description: 
Entity  Structure: 
Record: 

Created  By: 
Notes; 


Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


DKVIG 

Unstructured 

Contains  the  stif&iess  matrix  partitions. 


1.  Contains  all  of  a  portion  of  the  stif&iess  matrix  for  a  given  design  variable. 
Module  NLEMAl 

1.  Relation  GMKCTG  contains  connectivity  and  KCODE  information  which  de¬ 
fines  how  the  matrices  are  stored. 

2.  The  matrices  are  stored  in  the  same  precision  as  the  KGG  matrix. 

3.  The  INFO  array  contains  information  on  the  generation  of  the  mass  matrix. 
INFO(ll)  =  1  Generate  the  global  mass  matrix  in  the  final  analysis 

=  0  Don’t  generate  the  global  mass  matrix 
INFO(12)  =  1  Generate  the  global  mass  matrix  for  the  optimization 

DKIV 

Matrix 

An  intermediate  matrix  in  the  calculation  of  the  sensitivities  of  static  aeroelastic 
displacements. 

Rectangular  real  matrix  with  the  number  of  rows  equal  to  the  number  of  a-set 
degrees  and  the  number  of  columns  equal  to  the  number  of  active  displacement 
vectors  times  the  number  of  design  variables. 

MAPOL 

1.  This  matrix  is  the  solution  to: 

IKll] [DKIV]  =  [DPI] 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  lype: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


DLA6S 


Relation 

Contains  loading  information  for  a  dynamics  load  set  as  input  from  the  Bulk  Data 
file. 


NAME 

TYPE/KEY 

DESCRIPTION 

DSID 

Integer  >  0 

DLAGS  set  identification  ntimber 

LSID 

Integer  >  0 

Static  load  set  id  j 

TAU 

Real 

Time  delay  value  j 

PHASE 

Real 

Phase  lag  value  | 

Module  IFF 


DLOAD 

Relation 

Contains  d3niamic  loads  information  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0 

Load  set  identification  number 

SCAL 

Real 

Overall  scale  factor 

SCALI 

Real 

Scale  factor  for  this  tuple  | 

LOADI 

Integer  >  0 

ID  of  the  associated  TLOADi  or  RLOADi  set  I 
for  this  tuple  | 

Module  IFF 


1.  The  relation  is  used  in  the  transient  response  and/or  the  frequency  response 
module. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


Entity: 
Entity  lype: 
Description: 
Matrix  Form: 

Created  By: 


DLONLY 

Relation 

Contains  loads  information  for  dynamic  response  as  input  from  the  Bulk  Data  file. 


1 

NAME 

TYPE/KEY 

DESCRIPTION 

DSID 

Integer  >  0 

DLONLY  set  identification  number 

POINT 

Integer  >  0 

Grid,  scalar  or  extra  point  ID 

COMP 

Integer  >  0 

Component  number 

AVAL 

Real 

Load  value 

Module  IFP 

1.  Subroutine  PREDOL  processes  DLONLY  data  and  write  them  to  the  UD- 
LOLY  entity. 

2.  COMP  is  1-6  for  grid  points  and  zero  for  extra  or  scalar  points. 

DMA6 

Matrix 

Matrix  product  of  mass  design  sensitivity  matrices  and  active  acceleration  vectors. 

The  number  of  columns  is  equal  to  NAC,  the  number  of  active  subcases,  times  NDV, 
the  number  of  design  variables.  The  number  of  rows  is  equal  to  the  number  g-set 
degrees  of  freedom. 

MAKDVU 
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Entity: 

Entity  Type: 
Description: 

Entity  Structure: 
Record: 


Created  By: 
Notes: 


DMELM 

Unstructured 

An  unstructured  database  entity  that  contains  the  element  nonlinear  finite  differ¬ 
ence  mass  sensitivily  matrix  partitions. 


the  record  contains  a  partition  of  the  stiffiiess  matrix  with  either  one,  three, 
or  six  entries  for  each  node 


KCODE 

FORMAT  OF  RECORD 

7 

3  columns  of  3  entries/node 

10 

3  colunans  of  1  entry/node  (diagonal) 

Module  NLEMG 

1.  This  entity  contains  one  record  for  each  strip  of  each  element  nonlinear  de¬ 
sign  mass  sensitivity  matrix.  A  strip  or  partition  is  defined  as  all  those  col¬ 
umns  of  the  element  matrix  associated  with  a  pivot  sil  (the  id  of  the  first  dof 
of  a  grid  point  or  the  id  of  a  scsilar  point). 

2.  Refer  to  the  DDVCT  relation  for  further  details,  as  these  two  database  enti¬ 
ties  are  closely  linked. 

3.  The  matrix  partitions  are  stored  in  the  same  precision  as  the  MGG  matrix. 

4.  DMELM  and  MELM  are  used  to  generate  all  of  the  element  mass  sensitivity 
matrix  partitions. 


Entity: 

Entity  'lype: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 
Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 

Entity: 
Entity  Type: 
Description: 


DMIG 

Relation 

Contains  the  direct  matrix  input  data  for  structural  matrices  as  defined  in  the  BTolk 
Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

NAME 

Text  8 

Matrix  entity  name 

PREC 

Tfext  4 

Matrix  precision 

FORM 

Text  8 

Matrix  form 

GCOL 

Integer 

External  point  identification  of  column  index 

CCOL 

Integer 

Grid  component  number  of  column  index 

GROW 

Integer 

External  point  id  of  row  index 

CROW 

Integer 

Grid  point  component  of  row  index 

XU 

Real 

Real  part  of  matrix  term 

YU 

Real 

Imaginary  part  of  matrix  term 

Module  IFF 

DMU 

Matrix 

The  reduced  mass  sensitivity  matrix  used  in  the  calculation  of  sensitivities  of 
displacements  when  there  are  unrestrained  degrees  of  freedom. 

The  number  of  rows  is  equal  to  the  number  of  SUPPORT  degrees  of  fireedom  and 
the  number  of  columns  is  equal  to  the  number  of  columns  in  DMUG. 

MAPOL 

1.  This  matrix  is  computed  from: 

[  DMU  ]  =  [  ]^  *  [  ]  +  [  DMUR  ] 

DMUA 

Matrix 

A  partition  of  the  DMUF  matrix  (see  DMUG). 
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Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  IVpe: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


Entity: 
Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 


DMUF 


Matrix 

A  partition  of  the  DMU  matrix  (see  DMUG). 


D1XEU6 


Matrix 


Contains  the  product  of  the  mass  design  sensitivity  matrices  and  the  active  accel¬ 
eration  vectors. 

The  number  of  columns  is  equal  to  NAC,  the  number  of  active  subcases  times  NDV, 
the  number  of  design  variables.  The  number  of  rows  is  equal  to  the  number  of 
degrees  of  freedom  in  the  g-set. 

Module  MAKDVU 


1.  This  matrix  is  created  only  when  there  are  imrestrained  degrees  of  freedom. 

2.  The  sensitivity  to  the  first  design  variable  for  all  the  active  subcases  occupies 
the  first  NAC  columns.  This  is  followed  by  columns  for  each  of  the  remaining 
design  variables  in  turn. 

3.  The  negative  of  the  product  is  created  in  order  to  simplify  the  later  matrix  op¬ 
erations. 

4.  The  MAPOL  sequence  supports  the  partitions  of  the  DMUG  matrix  (see  the 
Theoretical  Manual  for  the  exphcity  formation  of  these  submatrices:) 


DMUG  -> 


DMUN 


DMUN 


9 

DMUF 


DMUF 

DMUA 


DMUO^ 

DMUA 

DMUR 

DMUL 


*  Generated  for  Guyan  reduction  only. 


DMOL 

Matrix 

A  partition  of  the  DMUA  matrix  (see  DMUG). 


DMUN 


Matrix 

A  partition  of  the  DMUG  matrix  (see  DMUG). 
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Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 
Entity  Structure: 
Record: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Entity  Structure: 
Record: 

Created  By: 
Notes: 


DMUO 

Matrix 

A  partition  of  the  DMUF  matrix  (see  DMUG). 

DNUR 

Matrix 

A  partition  of  the  DMUA  matrix  (see  DMUG). 


DMVI 

Unstructiured 

Contains  the  mass  design  sensitivity  matrices. 


i.  Contains  all  or  a  portion  of  the  mass  design  sensitivity  matrix  for  a  given  de¬ 
sign  variable. 

Module  NLEMAl 

1.  Relation  GMMCT  contains  connectivity  and  MCODE  information  which  de¬ 
fines  how  the  matrices  are  stored. 

2.  The  sensitivity  matrices  are  stored  in  the  same  precision  as  the  MGG  matrix. 

3.  DMVI  is  built  from  DMVIO  (which  contains  the  linear  mass  design  sensitivity 
matrix)  and  from  the  finite  difference  nonlinear  mass  design  sensitivity. 


DMVIO 

Unstructimed 

Contains  the  linear  mass  design  sensitivity  matrices. 


i.  Contains  all  or  a  portion  of  the  linear  mass  design  sensitivity  matrix  for  a 
given  design  variable. 

Module  NLEMAl 

1.  Relation  GMMCTO  contains  connectivity  and  MCODE  information  which  de¬ 
fines  how  the  matrices  aire  stored. 

2.  The  sensitivity  matrices  are  stored  in  the  same  precision  as  the  MGG  matrix. 
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DMVID 


Entity: 

Entity  Type: 
Description: 
Entity  Structure: 
Record: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Entity  Structure: 
Record: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Entity: 
Entity  Type: 
Description: 


Unstructured 

Contains  the  nonlinear  design  mass  matrix  partitions. 


i.  Contains  all  or  a  portion  of  the  nonlinear  design  mass  matrix  for  the  zeroth 
design  variable. 

Module  NLEMAl 

1.  Relation  GMMCTD  contains  connectivity  and  MCODE  information  which  de¬ 
fines  how  the  matrices  are  stored. 

2.  The  matrices  are  stored  in  the  same  precision  as  the  MGG  matrix. 

DMVIG 

Unstructured 

Contains  the  mass  matrix  partitions. 


i.  Contains  all  or  a  portion  of  the  mass  matrix  for  a  given  design  variable. 
Module  NLEMAl 

1.  Relation  GMMCTG  contains  connectivity  and  MCODE  information  which  de¬ 
fines  how  the  matrices  are  stored. 

2.  The  matrices  are  stored  in  the  same  precision  as  the  MGG  matrix. 

DPAV 

Matrix 

Partition  of  the  DPFV  matrix  (see  DPGV). 

DPFV 

Matrix 

Partition  of  the  DPNV  matrix  (see  DPGV). 
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Entity: 
Entity  Type: 
Description: 


Matrix  Form: 


Created  By: 
Notes: 


DPGRVD 

Matrix 

Contains  the  gravity  loads  related  to  nonlinear  design  elements  for  each  gravity 
load  set  referenced  in  solution  control. 

A  variable-sized  matrix  having  one  row  for  each  structural  degree  of  freedom  and 
one  column  for  each  gravity  load  condition  for  each  design  variable  (including  the 
zeroth  design  variable).  The  order  of  the  matrix  columns  is: 

(A)  The  NGRAV  columns  for  each  gravity  load  set  for  the  zeroth  design  vari¬ 
able  in  load  set  id  order. 

(B)  The  NGRAV  columns  for  each  gravity  load  set  for  the  first  design  variable 
in  load  set  id  order,  etc. 

NLLODGEN 

1.  This  matrix  is  empty  if  no  gravity  loads  are  referenced  in  solution  control  or 
in  a  LOAD  Bulk  Data  entry,  or  if  there  are  no  nonlinear  design  variables. 

2.  PPGRVD]  and  [DDPGRI]  are  used  to  generate  the  total  gravity  loads. 


Entity: 

Entity  Type: 
Description: 


Matrix  Form: 


Created  By: 
Notes: 


DPGRVI 

Matrix 

Contains  the  linear  gravity  load  sensitivities  for  each  gravity  load  set  referenced  in 
solution  control. 

A  variable-sized  matrix  having  one  row  for  each  structvLral  degree  of  freedom  and 
one  column  for  each  gravity  load  condition  for  each  design  variable  (including  the 
zeroth  design  variable).  The  order  of  the  matrix  columns  is: 

(A)  The  NGRAV  columns  for  each  gravity  load  set  for  the  zeroth  design  vari¬ 
able  in  load  set  id  order. 

(B)  The  NGRAV  columns  for  each  gravity  load  set  for  the  first  design  variable 
in  load  set  id  order,  etc. 

LODGEN 

1.  This  matrix  is  empty  if  no  gravity  loads  are  referenced  in  solution  control  or 
in  a  LOAD  Bulk  Data  entry,  or  if  there  are  neither  linear  design  variables  nor 
nondesigned  elements. 

2.  DDPGRVI]  and  [DDPGRV]  constitute  the  total  gravity  load  sensitivities. 

3.  [DPGRVI]  and  PPGRVD]  are  used  to  generate  the  total  gravity  load  at  the 
current  design  point. 
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Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 

Entity: 
Entity  T^pe: 
Description: 


DPGV 

Matrix 
See  Notes. 

Real  rectangular  matrix  with  one  row  for  each  g-set  degree  of  freedom.  The  number 
of  columns  is  equal  to  the  number  of  active  subcases  times  the  number  of  design 
variables. 

MAPOL  or  MAKDFU 


1.  For  the  Gradient  Method,  contains  the  right-hand  sides  for  the  sensitivity  cal¬ 
culations.  If  there  are  design  dependent  loads,  DPGV  is  the  sum  of  DPVJ  and 
DRUG.  If  there  are  no  design  dependent  loads,  DPGV  is  equivalent  to 
DRUG. 

2.  For  the  Virtual  Load  Method,  contains  the  sensitivities  of  the  currently  active 
constraints  to  the  global  displacements. 

3.  The  MAPOL  sequence  supports  the  following  partitions  of  the  DPVG  matrix 
(see  the  Theoretical  Manual  for  the  expHcit  formation  of  these  matrices): 


DPGV 


DPNV 


DPNV 

DPFV  ^ 

DPAV 


9 

DPFV 

DPOV* 

DPAV 

DPRV 

DPLV 


*  Generated  for  the  Guyan  reduction  only. 


DPLV3 

Matrix 

Partition  of  the  DPAV  matrix  (see  DPGV). 


DPNV 

Matrix 

Partition  of  the  DPGV  matrix  (see  DPGV). 


DPOV 

Matrix 

Partition  of  the  DPFV  matrix  (see  DPGV). 
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Entity: 

DPRV 

Entity  Type: 

Matrix 

Description: 

Partition  of  the  DPFV  matrix  (see  DPGV). 

Entity: 

DPTHVD 

Entity  Type: 

Matrix 

Description: 

Contains  the  thermal  loads  related  to  nonlinear  design  elements  for  each  thermal 
load  set  referenced  in  the  solution  control. 

Matrix  Form: 

A  variable-sized  matrix  having  one  row  for  each  structural  degree  of  freedom  and 
one  column  for  each  thermal  load  condition  for  each  design  variable  (including  the 
zeroth  design  variable).  The  order  of  the  matrix  columns  is: 

(A)  The  NTHERM  columns  for  each  thermal  load  set  for  the  zeroth  design 
variable  in  load  set  id  order. 

(B)  The  NTHERM  colxunns  for  each  thermal  load  set  for  the  first  design  vari¬ 
able  in  load  set  id  order,  etc. 

Created  By: 

Notes: 

Module  NLODGEN 

1.  This  matrix  is  empty  if  no  thermal  loads  are  referenced  in  solution  control,  or 
if  there  are  no  nonlinear  design  variables. 

3.  PPTHVD]  and  [DPTHVI]  Eure  used  to  generate  the  total  thermal  loads. 

Entity: 

DPTHVI 

Entity  Type: 

Matrix 

Description: 

Contains  the  linear  thermal  loads  sensitivities  for  each  thermal  load  set  referenced 
in  the  solution  control. 

Matrix  Form: 

A  variable-sized  matrix  having  one  row  for  each  structural  degree  of  freedom  and 
one  column  for  each  thermal  load  condition  for  each  design  variable  (including  the 
zeroth  design  variable).  The  order  of  the  matrix  columns  is: 

(A)  The  NTHERM  columns  for  each  thermal  load  set  for  the  zeroth  design 
variable  in  load  set  id  order. 

(B)  The  NTHERM  columns  for  each  thermal  load  set  for  the  first  design  vari¬ 
able  in  load  set  id  order,  etc. 

Created  By: 

Notes: 

Module  LODGEN 

1.  This  matrix  is  empty  if  no  thermal  loads  are  referenced  in  solution  control,  or 
if  there  are  neither  linear  design  variables  and  nor  nondesigned  element. 

2.  [DPTHVI]  and  [DDPTHV]  constitute  the  total  thermal  loads  sensitivities. 

3.  [DPTHVI]  and  [DPTHVD]  are  used  to  generate  the  total  thermal  load. 
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Entity: 

Entity  TVpe: 
Description: 
Matrix  Form: 


Created  By: 
Notes: 


Entity: 
Entity  T^e: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


DPVJ 

Matrix 

Contains  the  sensitivities  of  the  active  loads  to  the  design  variables. 

A  variable-size  matrix  having  one  row  for  each  structural  degree  of  freedom  and  one 
column  for  each  active  load  in  the  current  active  boundary  condition.  The  order  of 
the  columns  is  as  follows: 

(A)  The  sensitivities  of  each  active  load  condition  in  load  condition  order  for 
the  first  design  variable. 

(B)  The  sensitivities  of  each  active  load  condition  in  load  condition  order  to 
the  second  design  variable  etc 

Module  DDLOAD 

1.  If  any  one  load  condition  in  the  current  active  boundary  condition  is  design 
dependent,  the  full  DPVJ  matrix  must  be  created  so  that  the  DPVJ  and  the 
DKUG  matrices  are  conformable. 

2.  If  no  design  depend  loads  exist  in  the  current  active  boundary  condition,  the 
matrix  is  empty. 

3.  The  DPVJ  is  currently  built  from  the  appropriate  linear  combinations  of 
DPTHVI  and  DPGRVI  columns. 

DPI 

Matrix 

A  load  sensitivity  matrix  used  in  the  calculation  of  displacement  sensitivities  when 
there  are  unrestrained  degrees  of  freedom. 

A  rectangular  matrix  with  the  number  of  rows  equal  to  the  number  of  degrees  of 
freedom  in  the  a-set  and  the  number  of  columns  is  equal  to  the  product  of  the  number 
of  columns  equal  the  nmnber  of  columns  in  DPGV 

MAPOL 

1.  DPI  is  computed  by  performing  a  ROWMERGE  on  matrix  entities  DMU  and 
DPGL. 
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Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Entity  Structure: 
Record: 

Created  By: 
Notes: 


DRHS 

Matrix 

Sensitivity  of  the  applied  loads  to  the  changes  in  the  design  variables  after  they 
have  been  reduced  to  the  support  set. 

The  number  of  rows  is  equal  to  the  number  of  degrees  of  freedom  in  the  r-set  while 
the  number  of  design  variables  times  the  number  of  active  load  cases  as  determined 
by  the  ABOUND  module. 

MAPOL 

1 .  If  an  inertia  relief  sensitivily  analysis  is  being  per  formed,  DRHS  is  DPRV 
plus  the  transpose  of  D  times  DPLV. 

2.  If  a  static  aeroelastic  sensitivity  analysis  is  being  performed,  K21  times 
DKLV  is  subtracted  from  the  DRHS  defined  above. 

DTELM 

Unstructured 

Contains  the  element  design  nonlinear  thermal  load  sensitivity  partitions  for 
nonlinear  designed  elements  if  any  thermal  loads  have  been  defined  in  the  model. 


i.  Each  record  contains  the  geometric  and  material  thermal  load  sensitivity  par¬ 
titions  for  each  nonlinear  design  element  in  the  model  if  any  thermal  loads 
have  been  defined  in  the  model. 

Module  NLEMG 

1.  This  entity  contains  one  record  for  each  partition  of  each  nonlinear  element 
thermal  load  sensitivity  matrix.  A  partition  is  that  portion  of  the  matrix  con¬ 
nected  to  one  pivot  sil. 

2 .  Refer  to  the  DDVCT  relation  documentation  for  further  details . 

3.  The  DTELM  terms  are  stored  in  the  same  precision  as  the  PC  matrix. 

4.  DTELM  and  TELM  are  used  to  generate  all  of  the  element  thermal  load  sen¬ 
sitivity  matrix  partitions. 


Entity: 

DTSLP 

Entity  TVpe: 

Matrix 

Description: 

A  matrix  used  in  the  nuclear  blast  calculation  to  compute  the  slopes  at  the 
aerodynamic  panels  given  the  modal  participation  factors. 

Matrix  Form: 

A  real,  rectangular  matrix  with  the  number  of  rows  equal  to  the  number  of 
aerodynamic  panels  and  the  number  of  columns  equal  to  the  number  of  retained 
modes. 

Created  By: 

MAPOL 

Notes: 

1.  DTSLP  is  computed  using: 

[DTSLP  ]  =  [BLSTJA  [PHIB  ] 

Entity: 

DUAD 

Entity  Type: 

Matrix 

Description: 

Matrix  of  sensitivities  of  the  a-set  accelerations  to  changes  in  the  design  variables. 

Matrix  Form: 

The  number  of  rows  is  equal  to  the  number  of  degrees  of  freedom  in  the  a-set  while 
the  number  of  columns  is  equal  to  the  number  of  active  load  cases  times  the  number 
of  design  variables. 

Created  By: 

MAPOL 

Notes: 

1.  This  matrix  is  formed  by  merging  DURD  and  DULD. 

2.  This  matrix  is  constructed  only  when  there  is  inertia  relief  and  when  the  load 
vectors  have  been  determined  to  be  active  by  module  ABOUND. 

Entity: 

DUAV 

Entity  Type: 

Matrix 

Description: 

Sensitivity  of  displacements  in  the  a-set. 

Matrix  Form: 

The  number  of  columns  is  equal  to  the  number  of  active  subcases  times  the  number 
of  design  variables.  The  number  of  rows  is  equal  to  the  number  of  terms  in  the  a-set. 

Created  By: 

MAPOL,  Module  AEROSENS  or  Module  FBS 

Notes: 

1.  For  static  analysis  without  inertia  relief  DUAV  is  determined  by  FBS;  for  in¬ 
ertia  relief,  DUAV  is  merged  from  DURV  and  DULV  For  static  aeroelasticity, 
DUAV  is  calculated  in  AEROSENS. 
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Entity: 

Entity  IVpe: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


DUFV 

Matrix 

Sensitivity  of  displacements  in  the  f-set. 

The  number  of  coliunns  is  equal  to  the  niunber  of  active  subcases  times  the  number 
of  design  variables.  The  number  of  rows  is  equal  to  the  number  of  terms  in  the  f-set. 

MAPOL 

1.  For  generalized  dynamic  reduction,  DUFV  is  obtained  from  DUAV  and 
GSUBO.  For  Guyan  Reduction,  DUFV  is  obtained  from  merging  DUAV  and 
temporary  matrix  UO  which  represents  the  sensitivity  of  the  displacements 
in  the  o-set. 

DUG 

Matrix 

Summation  of  the  DKUG  and  DMUG  matrices. 

The  number  of  coltunns  is  equal  to  NAC,  the  number  of  active  subcases,  times  NDV, 
the  number  of  design  variables.  The  n\imber  of  columns  is  equal  to  the  number  of 
degrees  of  freedom  in  the  g-set. 

MAPOL 

1.  If  there  are  no  SUPPORT  degrees  of  freedom,  DUG  is  equivalenced  into 
DKUG. 

DULD 

Matrix 

Matrix  of  sensitivities  of  the  1-set  accelerations  to  changes  in  the  design  variables. 

The  number  of  rows  is  equal  to  the  number  of  degrees  of  freedom  in  the  1-set  while 
the  number  of  columns  is  equal  to  the  number  of  active  load  cases  times  the  number 
of  design  variables. 

MAPOL 

1.  This  matrix  is  formed  by  multiplying  D  by  DURD. 

2.  This  matrix  is  constructed  only  when  there  is  inertia  relief  and  when  the  load 
vectors  have  been  determined  to  be  active  by  module  ABOUND. 
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Entity; 

Entity  TVpe: 
Description: 

Matrix  Form: 

Created  By; 
Notes: 

Entity: 

Entity  'I^pe- 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


DULY 

Matrix 

Sensitivity  of  displacements  in  the  1-set.  The  computed  sensitivity  of  the  active 
subcases  to  changes  in  the  design  variable. 

The  number  of  columns  is  equal  to  the  number  of  active  subcases  times  the  number 
of  design  variables.  The  number  of  rows  is  equal  to  the  number  of  terms  in  the  1-set. 

Module  FBS 

1.  This  matrix  is  created  only  when  there  is  statics  with  inertia  relief  and  when 
the  load  vectors  have  been  determined  to  be  active  by  module  ABOUND. 


DURD 

Matrix 

The  sensitivity  of  the  rigid  body  acceleration  matrix  to  changes  in  the  design 
variables. 

Real  and  rectangular.  The  number  of  rows  is  equal  to  the  number  of  degrees  of 
freedom  in  the  r-set  while  the  number  of  coliimns  is  equal  to  the  number  of  active 
subcases  times  the  number  of  design  variables. 

Module  INERTIA 

1.  This  matrix  is  formed  only  when  there  is  inertia  relief  and  the  applied  load 
has  been  determined  to  be  active  by  module  ABOUND. 

2.  The  matrix  is  formed  by  solving 

[MRi?  ]  [DX7RD  ]  =  [DRHS  ] 
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DVCT 

Relation 

Contains  the  data  required  for  the  assembly  of  the  linear  portion  (in  analytical  form) 
of  design  sensitivity  matrices.  Relation  is  sorted  first  by  DVID  and  then  by  KSIL. 


NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  identification  number 

PREF 

Real 

Design  variable  linking  factor 

ALPHA 

Real 

Exponential  power  associated  with  the  design 
variable 

KSIL 

Integer  >  0 

Internal  identification  for  a  grid  connected  to 
the  element 

KCODE 

Integer  >  0 

A  code  word  denoting  the  form  in  which  the 
element  stiffness  matrix  is  stored 

MCODE 

Integer  >  0 

A  code  word  denoting  the  form  in  which  the 
element  mass  matrix  is  stored 

TCODE 

Integer  >  0 

A  code  word  denoting  the  form  in  which  the 
element  thermal  loads  sensitivities  are  stored  | 

TREFPT 

Integer 

The  position  in  TREE  for  the  associated 
reference  temperature 

NODES 

Integer  >  0 

The  number  of  nodes  connected  to  the  element 

IREC 

Integer  >  0 

The  record  number  of  the  unstructured  entity 
KELM,  MELM,  or  TELM  that  contains  the 
partition  of  the  element  matrix 

ASILS 

Ivector  (32) 

List  of  associated  sils  of  the  element  in  sorted 
order  | 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


Module  EMG 


1.  This  relation  contains  one  tuple  for  each  design  variable  for  each  node  of  each 
structural  element. 

2.  The  words  KCODE,  MCODE  and  TCODE  have  the  following  definition: 


KCODE /MCODE /TCODE 
FOR 

SCALAR  ELEMENTS 

MEANING  (No  meaning  for  TCODE) 

1 

Scalar  point  connected  to  ground 

2 

Grid  point  component  connected  to  a  scalar  point 

3 

Scalar  point  connected  to  grid  component 

4 

Scalar  point  connected  to  a  scalar  point 

5 

Grid  point  component  connected  to  ground 

6 

Grid  point  component  connected  to  a  second  grid  point 
component 

KCODE /MCODE/TCODE 
FOR  OTHER  ELEMENTS 
(CONNECTED  TO  GRID 
POINTS) 

MEANING 

7 

Element  has  extensional  DOF’s  only 

8 

Element  has  rotational  DOFs  only 

9 

Element  has  both  extension  and  rotation 

10 

Element  matrix  has  only  diagonal  extensional  entries 

11 

Element  matrix  has  only  diagonal  rotational  entries 

12 

Element  matrix  has  diagonal  entries  for  all  grid  point 
DOFs 

3.  A  KCODE,  MCODE  or  TCODE  of  zero  implies  that  the  element  has  no  associ¬ 
ated  stif&iess,  mass  or  thermal  load. 

4.  Design  variable  offset  value  is  stored  in  INFO(ll)  from  EMG.  It  is  used  for 
the  pseudo  design  variable  spawned  to  handle  the  nonlinear  portion  of  the 
BAR  element  stiffiiess. 

5.  7,  8,  and  9  are  the  only  values  supported  for  TCODE. 

6.  This  relation  contains  tuples  for  nonlinear  design  variables  for  which  related 
records  of  xmstructured  entities  KECM,  MECM  or  TECM  are  empty. 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes; 


DVCTD 

Relation 

Contains  the  data  required  for  the  assembly  of  the  nonlinear  design  element 
sensitivity  matrices.  Relation  is  sorted  by  KSIL. 


NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  identification  niunber 

PREF 

Real 

Design  variable  linking  factor 

ALPHA 

Real 

Exponential  power  associated  with  the  design 
variable 

KSIL 

Integer  >  0 

Internal  identification  for  a  grid  connected  to 
the  element  1 

KCODE 

Integer  >  0 

A  code  word  denoting  the  form  in  which  the  | 

element  stifftiess  matrix  is  stored 

MCODE 

Integer  >  0 

A  code  word  denoting  the  form  in  which  the 
element  mass  matrix  is  stored 

TCODE 

Integer  >  0 

A  code  word  denoting  the  form  in  which  the 
element  thermal  loads  sensitivities  are  stored 

TREFPT 

Integer 

The  position  in  TREE  for  the  associated 
reference  temperature 

NODES 

Integer  >  0 

The  number  of  nodes  connected  to  the  element 

IREC 

Integer  >  0 

The  record  number  of  the  ixnstructured  entity 
KELM,  MELM,  or  TELM  that  contains  the 
partition  of  the  element  matrix 

ASILS 

Ivector  (4) 

list  of  associated  sils  of  the  element  in  sorted  | 
order  j 

Created  By: 


Module  NLEMG 


Notes: 


Entity: 

Entity  l^e: 
Description: 
Entity  Structure: 


Created  By: 
Notes: 


1.  This  relation  contains  one  tuple  for  the  zeroth  design  variable  for  each  node 
of  each  nonlinear  design  structural  element. 

2.  The  words  KCODE,  MCODE  and  TCODE  have  the  following  definition: 


KCODE/MCODE /TCODE 

MEANING 

7 

Element  has  extensional  DOF’s  only 

8 

Element  has  rotational  DOF’s  only 

9 

Element  has  both  extension  and  rotation 

10 

Element  matrix  has  only  diagonal  extensional  entries 

11 

Element  matrix  has  only  diagonal  rotational  entries 

12 

Element  matrix  has  diagonal  entries  for  all  grid  point 
DOF’s 

3.  A  KCODE,  MCODE  or  TCODE  of  zero  implies  that  the  element  has  no  associ¬ 
ated  stiffness,  mass  or  thermal  load. 

4.  Design  variable  offset  value  is  stored  in  INFO(ll)  from  NLEMG.  It  is  used 
for  the  pseudo  design  variable  spawned  to  handle  the  non-hnear  portion  of 
the  BAR  element  stiffness. 

5.  7,  8,  and  9  are  the  only  values  supported  for  TCODE. 

6.  This  relation  contains  no  tuple  for  linear  design  variables. 

DVSIZE 

Unstructured 

Contains  memoiy  allocation  information  on  the  DVCT  relation. 

Record  1. 


WORD  1 

Maximum  ntimber  of  DVCT  tuples  associated  with  any 
one  design  variable  other  than  zero 

WORD  2 

Number  of  tuples  connected  to  "design  variable"  zero 

WORD  3  through 
NDV+2 

Number  of  tuples  connected  to  each  design  variable 

Module  EMG 

1.  Entity  contains  one  record  with  NDV  +2  words. 
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Entity: 

Entity  TVpe: 
Description: 
Entity  Structure: 


Created  By: 

Notes: 

Entity: 

Entity  lyp®* 
Description: 

Relation  Attributes: 


DVSIZED 

Unstructured 

Contains  memory  allocation  information  on  the  DVCTD  relation. 


Record  1. 


WORDl 

0 

WORD  2 

Number  of  tuples  connected  to  "design  variable"  zero 

WORD  3  through 
NDV+2 

0 

Module  NLEMG 

1.  Entity  contains  one  record  with  NDV  +2  words. 


DVTOPTE 

Relation 

Contains  the  designed  element  thickness  variation  type  definition  by  specifying  the 
element  identification  numbers. 


NAME 

TYPE/KEY 

DESCRIPTION 

TYPE 

Ifext  (8) 

Designed  element  thickness  variation 

TYPE 

Tfext  (8) 

Element  type 

EID 

Integer  >  0 

Element  identification  number 

Created  By: 


Module  IFF 


Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  I^pe: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  lype: 
Description: 

Entity  Structure: 
Record: 

Created  By: 
Notes: 


DVTOPTL 

Relation 

Contains  the  designed  element  thickness  variation  type  definition  by  specifying  the 
element  list  set  ID  numbers. 


NAME 

TYPE/KEY 

DESCRIPTION 

TYPE 

Text  (8) 

Designed  element  thickness  variation 

TYPE 

Text  (8) 

Element  type 

ELID 

Integer  >  0 

Element  list  set  ID  number 

Module  IFF 

DVTOPTP 

Relation 

Contains  the  designed  element  thickness  variation  type  definition  by  specifying  the 
element  property  identification  numbers. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

TYPE 

Itext  (8) 

Designed  element  thickness  variation 

TYPE 

Ttext  (8) 

Element  property  type  || 

PID 

Integer  >  0 

Element  property  identification  number  | 

Module  IFF 

DDW6H2 

Unstructured 

Contains  the  nonlinear  portion  of  DWGH,  the  sensitivities  of  the  weight  to  the 
design  variables. 


1,  Design  variable  identification  numbers  including  zeroth  design  variable. 

2.  The  nonlinear  portion  of  DWGH  corresponding  to  each  design  variable  ID  at 
the  1st  record. 

Module  NLEMAl 


The  length  of  each  record  is  NDV+1. 


Entity: 

Entity  Type: 
Description: 

Entity  Structure: 
Record: 

Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


DWGHl 

Unstructured 

Contains  the  linear  design  invariant  portion  of  DWGH,  the  sensitivities  of  the 
weight  to  the  design  variables. 


1.  Design  variable  identification  numbers  including  zeroth  design  variable. 

2.  The  invariant  portion  of  DWGH  corresponding  to  each  design  variable  ID  at 
the  1st  record. 

Module  EMAl 

The  length  of  each  record  is  NDV+1. 

DWNWSH 

Matrix 

Matrix  containing  downwaish  vectors  that  are  computed  for  unit  values  of  angle  of 
attack,  pitch  rate  and  trim  surface  deflection. 

Rectangular  real  matrix  with  three  columns  and  rows  equal  to  the  nximber  of  panels 
in  the  unsteady  aerodynamics  model. 

Module  BLASTFIT 

dyured 

Relation 

Contains  the  necessary  information  to  perform  general  dynamic  reduction  as  input 
from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

FMAX 

Real  >  0 

Highest  frequency  of  interest 

NVEC 

Integer  >  0 

Number  of  generalized  coordinates  desired  j 

NIT 

Integer  >  0 

1 

I  SEED 

Integer  >  0 

Not  Used 

NQDES 

Integer  >  0 

EPZ 

Real 

1  FACTOR 

Real 

Created  By: 


Module  IFF 


DIJK 


Entity: 

Entity  lype: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Matrix 

The  real  part  of  the  substantial  derivative  matrix. 

A  rectangular  complex  matrix  with  the  number  of  rows  equal  to  the  number  of 
aerodynamic  panels  and  the  number  of  columns  equal  to  the  number  of  aerodynamic 
degrees  of  freedom . 

Module  UNSTEADY 

1.  The  complete  substantial  derivative  matrix  is  equal  to: 

[DIJK]  +  (ik)  tD2JK] 

where  k  is  the  reduced  frequency. 

2.  The  number  of  J  degrees  of  freedom  is  INFO(ll). 

3.  The  number  of  K  degrees  of  freedom  is  INFO(12). 
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Entity; 

Entity  TVpe: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By; 


D2JK 

Matrix 

The  imaginary  part  of  the  substantial  derivative  matrix. 

A  complex  matrix  with  the  number  of  rows  equal  to  the  number  of  aerodynamic 
panels  and  the  number  of  columns  equal  to  the  number  of  aerodjmamic  degrees  of 
freedom. 

Module  UNSTEADY 

1.  The  complete  substantial  derivative  matrix  is  equal  to: 
tDlJK]  +  (iK)  [D2aK] 
where  k  is  the  reduced  frequency. 

EIDTYPE 

Relation 

Contains  the  list  of  element  identification  numbers  and  corresponding  element 
types. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

Text  (8) 

Element  type 

Module  IFP 
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Entity; 

Entity  IVpe: 
Description: 

Relation  Attributes: 


Created  By: 


EIGC 

Relation 

Contains  the  necessary  information  to  perform  complex  eigenvalue  analysis  as  input 
from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0,  key 

Set  identification  number 

METHOD 

Tfext  (8) 

Method  of  complex  eigenvalue 
extraction 

NORM 

Tfext  (8) 

Eigenvector  normalization  technique  j 

GRIDl 

Integer  >  0 

Grid  or  scalar  point  identification  1 

number  j 

COMPNTSl 

Integer  >  0 

Component  of  GRIDl  j 

ORTHPARM 

Real  >  0.0 

Mass  orthogonality  test  parameter 

PA 

Real 

The  real  part  of  complex  point  A 

QA 

Real 

The  imaginary  part  of  complex  point  B 

PB 

Real 

The  real  part  of  complex  point  A 

QB 

Real 

The  imaginary  part  of  complex  point  B 

WIDTH 

Real  >  0.0 

Width  of  region  in  complex  plane 

ROOTEST 

Integer  >  0 

Estimated  number  of  roots  in  the  range 

ROOTDES 

Integer  >  0 

Desired  number  of  roots 

Module  IFP 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 


EI6R 

Relation 

Contains  the  necessary  information  to  perform  real  eigenvalue  analysis  as  input 
from  the  Bvilk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0,  key 

Set  identification  number 

METHOD 

Text  (8) 

Method  of  eigenvalue  extraction 

MINFREQ 

Real  >  0.0 

Lower  bound  for  frequency 

MAXFREQ 

Real  >  0.0 

Upper  bound  for  frequency 

ROOTESTl 

Integer  >  0 

Estimated  number  of  roots  in  the  range 

ROOTDESl 

Integer  >  0 

Desired  number  of  roots 

ORTHPARM 

Real  >  0.0 

Mass  orthogonality  test  parameter 

NORM 

Text  (8) 

Eigenvector  normalization  technique 

GRIDl 

Integer  >  0 

Grid  or  scalar  point  identification 
number 

COMPNTSl 

Integer  >  0 

Component  of  GRIDl 

Module  IFP 


ELAS 

Matrix 

Intermediate  matrix  in  the  nuclear  blast  response  calculation  contaiaing  the  modal 
participation  factors  for  the  initially  trimmed  aircraft. 

ELAS  contams  one  column  and  the  number  of  rows  is  equal  to  the  number  of  elastic 
modes. 

Module  MAPOL 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


ELASEST 

Relation 

Contains  the  element  summary  data  for  the  ELASl  and  ELAS2  elements. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0, 
key 

Element  identification  number 

SILl,  SIL2 

Integer  >  0 

Internal  grid  or  scalar  point  identification  | 

number  1 

COMPNTl 

Integer  >  0 

Component  of  SILl  to  which  the  element  is 
attached 

COMPNT2 

Integer  >  0 

Component  of  SIL2  to  which  the  element  is 
attached 

K 

Real 

Stiffiiess  value 

GE 

Real 

Damping  coefficient 

STRSCOEF 

Real 

Stress  coefficient 

DESIGN 

Integer  >  0 

Design  flag,  nonzero  if  element  is  designed 

Module  MAKEST 


1.  This  relation  is  built  from  the  CELASl  and  CELAS2  relations  along  with  as¬ 
sociated  property  and  grid  relations.  It  contains  one  tuple  for  each  scalar 
spring  element  in  the  problem. 


ELEMDRVA 

Relation 

Contains  the  user  function  requested  element  stress  and  strain  response  sensitivity 
information. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

MXCOL 

Integer  >  0 

Matrix  column  number  in  [MXELMDVA]  for 
the  sensitivity  values 

Module  MKAMAT 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


ELEMLIST 

Relation 

Contains  the  list  of  elements  for  which  element  dependent  outputs  are  requested  as 
input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0 

Design  variable  identification  number 

ETYPE 

Text  (8) 

Element  type.  One  of  the  following: 

BAR  QDMEMl 

ELAS  QUAD4 

IHEXl  ROD 

IHEX2  SHEAR 

IHEX3  TRIAS 

TRMEM 

EID 

Integer  >  0 

Element  identification  niunber 

Module  IFF 

ELEMRESP 

Relation 

Contains  the  user  function  requested  element  stress  and  strain  response  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value 

Created  By: 


Module  SCEVAL 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


ELIST 

Relation 


Contains  the  element  i 
Bulk  Data  entry. 

dentification  numbers  of  elements  specified  on  the  ELIST 

NAME 

TYP 

■/KEY 

DESCRIPTION 

LINKID 

Integ< 

)r  >  0 

ELIST  set  identification  number 

ETYPEl 

Tfext  (8) 

Element  type 

EIDl 

Integer  >  0 

Element  identification  number 

Created  By: 
Notes: 


Module  IFF 


1.  Allowable  ETYPEl  entries  are: 

-  CROD,  CONROD 

-  CSHEAR 

-  CQDMEMl 

-  CQUAD4 

-  CTRIA3 

-  CTRMEM 


CMASSl,  CMASS2 

CBAR 

CONM2 

CELASl,  CELAS2 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


ELISTM 

Relation 

Contains  the  element  identification  numbers  of  elements  specified  on  the  ELISTM 
Bulk  Data  entry. 


NAME 

TYPE/KEY 

DESCRIPTION 

LINKID 

Integer  >  0 

ELIST  set  identification  number 

ETYPEl 

Tfext  (8) 

Element  type 

EIDl 

Integer  >  0 

Element  identification  number 

DVSYMBL 

'Ifext(8) 

Designed  dimension  symbol 

Module  IFF 

1.  Allowable  ETYPEl  entries  are: 

-  CROD.CONROD  -  CMASSl,  CMASS2 

-  CSHEAR  -  CBAR 

-  CQDMEMl  -  CONM2 

-  CQUAD4  -  CELASl,  CELAS2 

-  CTRIA3 

-  CTRMEM 

2.  Allowable  DVSYMBL  are: 

-  Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9,  DIO  for  BAR  element 
cross  section  dimensions; 

A  for  element  cross  section  area; 

T  for  element  thickness; 

M  for  element  mass; 

K  for  element  thickness. 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


EOBAR 

Relation 

Contains  the  element  response  quantities  for  the  BAR  element. 


NAME 

TYPE/KEY 

DESCRIPTION 

OAFLAG 

2  >  Integer  >  1 

Optimize/analyze  flag 
=1  Optimization 
=2  Analysis 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

BCID 

Integer  >  0 

Boimdary  condition  identification  number 

DISC 

Integer  >  0 

Discipline  type 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  number  if  (DISC  =  1,  3, 

5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

String 

Element  type  (“BAR”) 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities 
=  2  if  complex  response  quantities 

ESER 

Real 

Real  part  of  element  strain  energy 

ESEI 

Real 

Imaginary  part  of  element  strain  energy 

RSAl 

Real 

Real  part  of  first  bending  stress  at  end  A 

ISAl 

Real 

Imaginary  part  of  first  bending  stress  at  end  A 

RSA2 

Real 

Real  part  of  second  bending  stress  at  end  A 

ISA2 

Real 

Imaginary  part  of  second  bending  stress  at  end 

A 

RSA3 

Real 

Real  part  of  third  bending  stress  at  end  A 

ISA3 

Real 

Imaginary  part  of  third  bending  stress  at  end  A 

RSA4 

Real 

Real  part  of  fourth  bending  stress  at  end  A 

ISA4 

Real 

Imaginary  part  of  fourth  bending  stress  at  end 

A 

RAAX 

Real 

Real  part  of  axial  stress  at  end  A 

lAAX 

Real 

Imaginary  part  of  axial  stress  at  end  A 

MAXA 

Reeil 

Maximum  stress  at  end  A 

MINA 

Real 

Minimum  stress  at  end  A 
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F 


NAME 

TYPE/KEY 

DESCRIPTION 

TSAFE 

Real 

Safety  margin  in  tension 

RSBl 

Real 

Real  part  of  first  bending  stress  at  end  B 

ISBl 

Real 

Imaginaiy  part  of  first  bending  stress  at  end  B 

RSB2 

Real 

Real  part  of  second  bending  stress  at  end  B 

ISB2 

Real 

Imaginary  part  of  second  bending  stress  at  end 

B 

RSB3 

Real 

Real  part  of  third  bending  stress  at  end  B 

ISB3 

Real 

Imaginary  part  of  third  bending  stress  at  end  B 

RSB4 

Real 

Real  part  of  fointh  bending  stress  at  end  B 

ISB4 

Real 

Imaginary  part  of  fotuih  bending  stress  at  end 

B 

RBAX 

Real 

Real  part  of  axial  stress  at  end  B 

I  BAX 

Real 

Imaginary  part  of  axial  stress  at  end  B 

MAXB 

Real 

Maximum  stress  at  end  B  j 

MINB 

Real 

Minimum  stress  at  end  B  I 

CSAFE 

Real 

Safety  margin  in  compression 

RSNAl 

i  Real 

Real  part  of  first  bending  strain  at  end  A  1 

ISNAl 

Real 

Imaginary  part  of  first  bending  strain  at  end  A  j 

RSNA2 

Real 

Real  part  of  second  bending  strain  at  end  A  j 

ISNA2 

Real 

Imaginary  part  of  second  bending  strain  at  end 

A 

RSNA3 

Real 

Real  part  of  third  bending  strain  at  end  A 

ISNA3 

Real 

Imaginary  part  of  third  bending  strain  at  end  A  | 

RSNA4 

Real 

Real  part  of  fourth  bending  strain  at  end  A  I 

ISNA4 

Real 

Imaginary  part  of  fourth  bending  strain  at  end 

A 

RAAXN 

Real 

Real  part  of  axial  strain  at  end  A 

lAAXN 

Real 

Imaginary  part  of  axial  strain  at  end  A  j 

MAXAN 

Real 

Maximum  strain  at  end  A  I 

MINAN 

Real 

Minimum  strain  at  end  A  1 

RSNBl 

Real 

Real  part  of  first  bending  strain  at  end  B  j 

ISNBl 

Real 

Imaginary  part  of  first  bending  strain  at  end  B  | 

RSNB2 

Real 

Real  part  of  second  bending  strain  at  end  B  j 
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NAME 

TYPE/KEY 

DESCRIPTION 

ISNB2 

Real 

Imaginary  part  of  second  bending  strain  at  end 

B 

RSNB3 

Real 

Real  part  of  third  bending  strain  at  end  B 

ISNB3 

Real 

Imaginary  part  of  third  bending  strain  at  end  B 

RSNB4 

Real 

Real  part  of  fourth  bending  strain  at  end  B 

ISNB4 

Real 

Imaginary  part  of  fourth  bending  strain  at  end 

B 

RBAXN 

Real 

Real  part  of  axial  strain  at  end  B 

IBAXN 

Real 

Imaginary  part  of  axial  strain  at  end  B 

MAXBN 

Real 

Maximmn  stram  at  end  B 

MINBN 

Real 

Minumum  strain  at  end  B 

RBMAl 

Real 

Real  part  of  bending  moment  A1 

IBMAl 

Real 

Imaginary  part  of  bending  moment  A1 

RBMA2 

Real 

Real  part  of  bending  moment  A2 

IBMA2 

Real 

Imaginary  part  of  bending  moment  A2 

RBMBl 

Real 

Real  part  of  bending  moment  B1 

IBMBl 

Real 

Imaginary  part  of  bending  moment  B1 

RBMB2 

Real 

Real  part  of  bendiug  moment  B2 

IBMB2 

Real 

Imaginary  part  of  bending  moment  B2 

RSHEARl 

Real 

Real  part  of  shear  1 

ISHEARl 

Real 

Imaginary  part  of  shear  1 

RSHEAR2 

Real 

Real  part  of  shear  2 

ISHEAR2 

Real 

Imaginary  part  of  shear  2 

RFORAX 

Real 

Real  part  of  axial  force 

IFORAX 

Real 

Imaginary  part  of  axial  force 

RTORQUE 

Real 

Real  part  of  torque 

ITORQUE 

Real 

Imaginary  part  of  torque 

Created  By: 
Notes: 


Module  EDR 

1.  This  relation  is  used  by  module  OFPEDR  for  output  printing  and  punching. 
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Entity: 
Entity  Type: 
Description: 

Record: 


Created  By: 
Notes: 


EODISC 

Unstructured 

Contains  the  element  discipline  types  and  their  subcases  for  which  element  response 
quantities  are  to  be  computed  for  each  element  in  the  structural  model  for  each 
boimdary  condition. 


i.  Record  i  contains  the  following  for  each  EID/BCID  combination  to  the  EO- 
SUMMARY  relation. 


WORD 

CONTENTS 

1 

NDISC,  the  number  of  disciplines  in  the  EODISC  record 

2 

DISC,  discipline  ID  for  the  current  discipline 

3 

NSUB,  the  number  of  subcases  for  which  output  is  desired 
from  discipline  DISC 

4  to  3+NSUB 

SUBi,  the  subcase  numbers  in  sorted  order 

Module  PFBULK 

1.  Words  2  through  4+NSUB  are  repeated  for  each  of  the  NDISC  disciplines  to 
generate  a  record  in  the  form. 

NDISC  (DISCi,  NSUBi,  (SUBy)  ,  j-  1,NSUB),  i=  1,  NDISC) 

2.  Each  record  of  EODISC  is  referenced  by  the  RECORD  attribute  of  the  EO- 
SUMMARY  relation. 

3.  The  EOSUMMARY/EODISC  combination  is  used  by  EDR  and  OFPEDR  to 
control  element  response  quantity  computations. 

4.  Each  record  is  ordered  in  discipline,  in  subcase  order. 

5.  The  records  are  ordered  by  boimdary  condition  ID,  element  type  (alphabeti¬ 
cal)  and  element  ID. 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


EOELAS 

Relation 

Contains  the  element  response  quantities  for  the  ELAS  element. 


NAME 

TYPE/KEY 

DESCRIPTION 

OAFLAG 

2  >  Integer  >  1 

Optimize/analyze  flag 
=1  Optimization 
=2  Analysis 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

BCID 

Integer  >  0 

Boundary  condition  identification  number 

DISC 

Integer  >  0 

Discipline  t3qDe 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  number  if  (DISC  =  1,  3, 

5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

String 

Element  type  (“ELAS”) 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities 
=  2  if  complex  response  quantities 

ESER 

Real 

Real  part  of  element  strain  energy 

ESEI 

Real 

Imaginary  part  of  element  straiin  energy 

STRSR 

Real 

Real  part  of  stress 

STRSI 

Real 

Imaginary  part  of  stress 

FORR 

Real 

Real  part  of  force 

FORI 

Real 

Imaginary  part  of  force 

Module  EDR 


1.  This  relation  is  used  by  module  OFPEDR  for  output  printing  and  punching. 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


NAME 

TYPE/KEY 

DESCRIPTION 

OAFLAG 

2  >  Integer  >  1 

Optimize/analyze  flag 
=1  Optimization 
=2  Analysis 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

BCID 

Integer  >  0 

Boimdary  condition  identification  number 

DISC 

Integer  >  0 

Discipline  type 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  number  if  (DISC  = 

1,  3,  5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

String 

Element  type  (“IHEXl”) 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities 
=  2  if  complex  response  quantities 

GID 

Integer  >  0 

Stress  point  identification  number 

ESER 

Real 

Real  part  of  element  strain  energy 

ESEI 

Real 

Imaginary  psirt  of  element  strain  energy 

RSTRSX 

Real 

Real  part  of  normal  stress  in  x-direction 

ISTRSX 

Real 

Imaginary  part  of  normal  stress  in  x- 
direction 

RSSXY 

Real 

Real  part  of  shear  stress  in  xy-plane 

ISSXY 

Real 

Imaginary  part  of  shear  stress  in  xy-plane 

PSTRESSl 

Real 

First  principal  stress 

XCOSl 

Real 

First  principal  x  cosine 

XCOS2 

Real 

Second  principal  x  cosine 

XCOS3 

Real 

Third  principal  x  cosine 

— 

MEANSTRS 

Real 

Mean  stress  | 

OCTSTRS 

Real 

Octahedral  shear  stress 

RSTRSY 

Real 

Real  part  of  normal  stress  in  y-direction  | 

EOHEXl 

Relation 

Contains  the  element  response  quantities  for  the  IHEXl  element. 
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NAME 

ISTRSY 


RSSYZ 


ISSYZ 


PSTRESS2 


YCOSl 


YCOS2 


YCOS3 


RSTRSZ 


ISTRSZ 


RSSZX 


ISSZX 


TYPE/KEY 

Real 


ISTRJSIX 


RSNXY 

ISNXY 


PSTRAINl 


XCOSIN 


XCOS2N 


XCOS3N 


MEANSTRN 


OCTSTRN 


RSTRNY 


ISTRNY 


RSNYZ 


DESCRIPTION 

Imaginary  part  of  normal  stress  in  y- 
direction 


Resil  part  of  normal  stress  in  yz-direction 


Imaginary  part  of  normal  stress  in  yz- 
direction 


Second  principal  stress 


First  principal  y  cosine 


Second  principal  y  cosine 


Third  principal  y  cosine 


Real  part  of  normal  stress  in  z-direction 


Imaginary  part  of  normal  stress  in  z- 
direction 


Real  part  of  shear  stress  in  zx-plane 


Imaginary  part  of  shear  stress  in  zx-plane 


Real 

Third  principal  stress 

Real 

First  principal  z  cosine 

ZCOS2 

Real 

Second  principal  z  cosine 

ZCOS3 

Real 

Third  principal  z  cosine 

RSTRNX 

j  Real 

Real  part  of  normal  strain  in  x-direction 

Imaginary  part  of  normal  strain  in  x- 
direction 


Real  part  of  shear  strain  in  xy-plane _ 

Imaginary  part  of  shear  strain  in  xy-plane 


First  principal  strain 


First  principal  x  cosine 


Second  principal  x  cosine 


Third  principal  x  cosine 


Mean  strain 


Octahedral  shear  strain 


Real  part  of  normal  strain  in  y-direction 


Imaginary  part  of  normal  strain  in  y- 
direction 

Real  part  of  shear  strain  in  yz-plane 


Imaginary  part  of  shear  strain  in  yz-plane 


ISNYZ 


NAME 

TYPE/KEY 

DESCRIPTION 

PSTRAIN2 

Real 

Second  principal  strain  j 

YCOSIN 

Real 

First  principal  y  cosine 

YCOS2N 

Real 

Second  principal  y  cosine 

YCOS3N 

Real 

Third  principal  y  cosine 

RSTRNZ 

Real 

Real  part  of  normal  strain  in  z-direction 

ISTRNZ 

Real 

Imaginary  part  of  normal  strain  in  z- 
direction 

RSNZX 

Real 

Real  part  of  shear  strain  in  zx-plane 

ISNZX 

Real 

Imaginary  part  of  shear  strain  in  zx-plane 

PSTRAIN3 

Real 

Third  principal  strain 

ZCOSIN 

Real 

First  principal  z  cosine 

ZCOS2N 

Real 

Second  principal  z  cosine  | 

ZCOS3N 

Real 

Third  principal  z  cosine 

Created  By:  Module  EDR 

Notes: 

1.  This  relation  is  used  by  module  OFPEDR  for  output  printing  and  punching. 

2.  One  tuple  exists  for  each  of  the  nine  stress  points  in  the  element. 

3.  The  first  eight  stress  points  (attribute  GID)  are  coincident  with  the  element 
grid  points  and  are  numbered  1  through  8  in  the  order  that  the  grid  points 
are  specified  on  the  CIHEXl  entity.  The  ninth  stress  point  (GID=9)  is  located 
at  the  center  of  the  element. 


Entity: 

Entity  I^pe: 
Description: 
Relation  Attributes: 


NAME 

TYPE/KEY 

DESCRIPTION 

OAFLAG 

2  >  Integer  >  1 

Optimize/analyze  flag 
=1  Optimization 
=2  Analysis 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

BCID 

Integer  >  0 

Boundary  condition  identification  number 

DISC 

Integer  >  0 

Discipline  type 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  number  if  (DISC  = 

1,  3,  5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

String 

Element  type  (“IHEX2”) 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities 
=  2  if  complex  response  quantities 

GID 

Integer  >  0 

Stress  point  identification  number 

ESER 

Real 

Real  part  of  element  strain  energy 

ESEI 

Real 

Imaginary  part  of  element  strain  energy 

RSTRSX 

Real 

Real  part  of  normal  stress  in  x-direction 

ISTRSX 

Real 

Imaginary  part  of  normal  stress  in  x- 
direction 

RSSXY 

Real 

Real  part  of  shear  stress  in  xy-plane 

ISSXY 

Real 

Imaginary  part  of  shear  stress  in  xy-plane 

PSTRESSl 

Real 

First  principal  stress 

XCOSl 

Real 

First  principal  x  cosine 

XCOS2 

Real 

Second  principal  x  cosine 

XCOS3 

Real 

Third  principal  x  cosine 

MEANSTRS 

Real 

Mean  stress  j 

OCTSTRS 

Real 

Octahedral  shear  stress  j 

RSTRSY 

Real 

Real  part  of  normal  stress  in  y-direction  j 

EOHEX2 

Relation 

Contains  the  element  response  quantities  for  the  IHEX2  element. 


576 


NAME 


TYPE/KEY 


DESCRIPTION 


ISTRSY 

Real 

Imaginary  part  of  normal  stress  in  y- 
direction 

RSSYZ 

Real 

Real  part  of  normal  stress  in  yz-plane 

ISSYZ 

Real 

Imaginary  part  of  normal  stress  in  yz-plane  I 

PSTRESS2 

Real 

Second  principal  stress 

YCOSl 

Real 

First  principal  y  cosine 

YCOS2 

Real 

Second  principal  y  cosine 

YCOS3 

Real 

Third  principal  y  cosine 

RSTRSZ 

Real 

Real  part  of  normal  stress  in  z-direction 

ISTRSZ 

Real 

Imaginary  part  of  normal  stress  in  z- 
direction 

RSSZX 

Real 

Real  part  of  shear  stress  in  xy-plane 

ISSZX 

Real 

Imaginary  part  of  shear  stress  in  xy-plane 

PSTRESS3 

Real 

Third  principal  stress 

ZCOSl 

Real 

First  principal  z  cosine 

ZCOS2 

Real 

Second  principal  z  cosine 

ZCOS3 

Real 

Third  principal  z  cosine 

RSTRNX 

Real 

1  Real  part  of  normal  strain  in  x-direction  | 

ISTRJSFX 

Real 

Imaginary  part  of  normal  strain  in  x- 
direction 

RSNXY 

Real 

Real  part  of  shear  strain  in  xy-plane  1 

ISNXY 

Real 

Imaginairy  part  of  shear  strain  in  xy-plane  | 

PSTRAINl 

Real 

First  principal  strain 

XCOSIN 

Real 

First  principal  x  cosine 

XCOS2N 

Real 

Second  principal  x  cosine 

XCOS3N 

Real 

Third  principal  x  cosine 

MEANSTRN 

Real 

Mean  strain 

OCTSTRN 

Real 

Octahedral  shear  strain 

RSTRNY 

Real 

Real  part  of  normal  strain  in  y-direction 

ISTRISIY 

Real 

Imaginary  part  of  normal  strain  in  y-  | 

direction  1 

RSNYZ 

Real 

Real  part  of  shear  strain  in  yz-plane  I 

ISNYZ 

Real 

Imaginary  part  of  shear  strain  in  yz-plane 

PSTRAIN2 

Real 

Second  principal  strain  1 
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Created  By: 
Notes: 


NAME 

TYPE/KEY 

DESCRIPTION 

YCOSIN 

Real 

First  principal  y  cosine 

YCOS2N 

Real 

Second  principal  y  cosine 

YCOS3N 

Real 

Third  principal  y  cosine 

RSTRNZ 

Real 

Reed  part  of  normal  strain  in  z-direction 

ISTRNZ 

Real 

Imaginary  part  of  normal  strain  in  z- 
direction 

RSTZX 

;  Real 

Real  part  of  shear  strain  in  z-direction 

ISNZX 

Real 

Imaginary  part  of  shear  strain  in  z- 
direction 

PSTRAIN3 

Real 

Third  principal  stram 

ZCOSIN 

Real 

First  principal  z  cosine 

ZCOS2N 

Real 

Second  principal  z  cosine 

ZCOS3N 

Real 

Third  principal  z  cosine  | 

Module  EDR 

1.  This  relation  is  used  by  module  OFPEDR  for  output  printing  and  punching. 

2.  One  tuple  exists  for  each  of  the  nine  stress  points  in  the  element. 

3.  The  first  20  stress  points  are  in  the  same  order  as  the  grid  points  are  speci¬ 
fied  on  the  CIHEX2  entity  and  are  numbered  1  through  20,  The  comer  stress 
points  coincident  with  the  comer  grid  points  while  the  mid-edge  stress  points 
are  exactly  at  the  mid-edge  point.  The  21st  stress  point  is  located  at  the  ele¬ 
ment  center. 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


EOHEX3 

Relation 

Contains  the  element  response  quantities  for  the  IHEX3  element. 


NAME 

TYPE/KEY 

DESCRIPTION 

OAFLAG 

2  >  Integer  >  1 

Optimize/analyze  flag 
=1  Optimization 
=2  Analysis 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

BCID 

Integer  >  0 

Boimdary  condition  identification  number 

DISC 

Integer  >  0 

Discipline  type 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  nvunber  if  (DISC  = 

1,  3,  5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

String 

Element  type  (“IHEX3”) 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities  1 

=  2  if  complex  response  quantities  j 

GID 

Integer  >  0 

Stress  point  identification  number 

ESER 

Real 

Real  part  of  element  strain  energy  | 

ESEI 

Real 

Imaginary  part  of  element  strain  energy 

RSTRSX 

Real 

Real  part  of  normal  stress  in  x-direction  j 

ISTRSX 

Real 

Imaginary  part  of  normal  stress  in  x- 
direction 

RSSXY 

Real 

Real  part  of  shear  stress  in  xy-plane 

ISSXY 

Real 

Imaginary  part  of  shear  stress  in  xy-plane 

PSTRESSl 

Real 

First  principal  stress  1 

XCOSl 

Real 

First  principal  x  cosine  j 

XCOS2 

Real 

Second  principal  x  cosine  | 

XCOS3 

Real 

Third  principal  x  cosine 

MEANSTRS 

Real 

Mean  stress 

OCTSTRS 

Real 

Octahedral  shear  stress  | 

RSTRSY 

Real 

Read  part  of  normal  stress  in  y-direction  j 

NAME 


TYPE/KEY 


DESCRIPTION 


ISTRSY 

Real 

Imaginary  part  of  normal  stress  in  y- 
direction 

RSSYZ 

Real 

Real  part  of  normal  stress  in  yz-plane 

ISSYZ 

Real 

Imaginary  part  of  normal  stress  in  yz-plane 

PSTRESS2 

Real 

Second  principal  stress 

YCOSl 

Real 

First  principal  y  cosine 

YCOS2 

Real 

Second  principal  y  cosine 

YCOS3 

Real 

Third  principal  y  cosine 

RSTRSZ 

Real 

Real  part  of  normal  stress  in  z-direction 

ISTRSZ 

Real 

Imaginary  part  of  normal  stress  in  z- 
direction 

RSSZX 

Real 

Real  part  of  shear  stress  in  xy-plane 

Real 

Imaginary  part  of  shear  stress  in  xy-plane 

Real 

Third  principal  stress 

ZCOSl 

Real 

First  principal  z  cosine 

ZCOS2 

Real 

Second  principal  z  cosine 

ZCOS3 

Real 

Third  principal  z  cosine 

RSTRNX 

Real 

Real  part  of  normal  strain  in  x-direction 

ISTRNX 

Real 

Imaginary  part  of  normal  strain  in  x- 
direction 

RSNXY 

Real 

Real  part  of  shear  strain  in  xy-plane 

ISNXY 

Real 

Imaginary  part  of  shear  strain  in  xy-plane 

PSTRAINl 

Real 

First  principal  strain 

XCOSIN 

Real 

First  principal  x  cosine 

XCOS2N 

Real 

Second  principal  x  cosine 

XCOS3N 

Real 

Third  principal  x  cosine 

MEANSTRN 

Real 

Mean  strain 

OCTSTRN 

Real 

Octahedral  shear  strain 

RSTRNY 

Real 

Real  part  of  normal  strain  in  y-direction 

ISTRNY 

Real 

Imaginary  part  of  normal  strain  in  y- 
direction 

RSNYZ 

Real 

Real  part  of  shear  strain  in  yz-plane 

ISNYZ 

Real 

Imaginary  part  of  shear  strain  in  yz-plane 

PSTRAIN2 

Real 

Second  principal  strain 
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NAME 

TYPE/KEY 

DESCRIPTION 

YCOSIN 

Real 

First  principal  y  cosine 

YCOS2N 

Real 

Second  principal  y  cosine 

YCOS3N 

Resd 

Third  principal  y  cosine 

RSTRNZ 

Real 

Real  pEirt  of  normal  strain  in  z-direction 

ISTRNZ 

Real 

Imaginary  part  of  normal  strain  in  z- 
direction 

RSTZX 

Real 

Real  part  of  shear  strain  in  z-direction 

ISNZX 

Real 

Imaginary  part  of  shear  strain  in  z- 
direction 

PSTRAIN3 

Real 

Third  principal  strain 

ZCOSIN 

Real 

First  principal  z  cosine 

ZCOS2N 

Real 

Second  principal  z  cosine 

ZCOS3N 

Real 

Third  principal  z  cosine 

Created  By:  Module  EDR 

Notes: 

1.  This  relation  is  used  by  module  OFPEDR  for  output  printing  and  punching. 

2.  One  tuple  exists  for  each  of  the  nine  stress  points  in  the  element. 

3.  The  first  20  stress  points  are  in  the  same  order  as  the  grid  points  are  speci¬ 
fied  on  the  CIHEX3  entity  and  are  numbered  1  through  20.  The  comer  stress 
points  coincident  with  the  comer  grid  points  while  the  mid-edge  stress  points 
are  exactly  at  the  mid-edge  point.  The  21st  stress  point  is  located  at  the  ele¬ 
ment  center. 
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EOQDMMl 

Relation 

Contains  the  element  response  quantities  for  the 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


NAME 

TYPE/KEY 

DESCRIPTION  1 

OAFLAG 

2  >  Integer  >  1 

Optimize/analyze  flag  1 

=1  Optimization  | 

=2  Analysis  1 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

BCID 

Integer  >  0 

Boundary  condition  identification  number  I 

DISC 

Integer  >  0 

Discipline  type  1 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  number  if  (DISC  = 

1,  3,  5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

string 

Element  type  (“QDMEMl”) 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities 
=  2  if  complex  response  quantities 

LAYRNUM 

Integer  >  0 

Layer  number 

ESER 

Real 

Real  part  of  element  strain  energy 

ESEI 

Real 

Imaginary  part  of  element  strain  energy 

RSTRSX 

Real 

Real  part  of  normal  stress  in  x-direction 

ISTRSX 

Real 

Imaginary  part  of  normal  stress  in  x- 
direction 

RSTRSY 

Real 

Real  part  of  normal  stress  in  y-direction 

ISTRSY 

Real 

Imaginary  part  of  normal  stress  in  y- 
direction 

RSTRSS 

Real 

Real  part  of  shear  stress  | 

ISTRSS 

Real 

Imaginary  part  of  shear  stress  | 

THSTRS 

Real 

Principal  angle  for  stress  1 

STRSl 

Real 

Major  principal  stress  | 

STRS2 

Real 

Minor  principal  stress 

MSSTRS 

Real 

Maximum  shear  stress  1 

RSTRNX 

Real 

Real  part  of  normal  strzdn  in  x-direction  j 
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Created  By: 
Notes: 


NAME 

TYPE/KEY 

DESCRIPTION 

ISTRNX 

Real 

Imaginary  part  of  normal  strain  in  x- 
direction 

RSTRNY 

Real 

Real  part  of  normal  strain  in  y-direction 

ISTRNY 

Real 

Imaginary  part  of  normal  strain  in  y- 
direction 

RSTRNS 

Real 

Real  part  of  shear  strain 

ISTRNS 

Real 

Imaginary  part  of  shear  strain 

THSTRN 

Real 

Principal  angle  for  strain 

STRNl 

Real 

Major  principal  strain 

STRN2 

Real 

Minor  principal  atrain 

MSSTRN 

Real 

Maximum  shear  strain 

RFX 

Real 

Real  part  of  force  in  x-direction 

IPX 

Real 

Imaginary  part  of  force  in  x-direction 

RFY 

Real 

Real  part  of  force  in  y-direction  [ 

IFY 

Real 

Imaginary  part  of  force  in  y-direction  j 

RFXY 

Real 

Real  part  of  shear  force  in  xy-plane 

IFXY 

Real 

Imaginary  part  of  shear  force  in  xy-plane  j 

Module  EDR 

1.  This  relation  is  used  by  module  OFPEDR  for  output  printing  and  pxmching. 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


EOQUAD4 

Relation 

Contains  the  element  response  quantities  for  the  QUAD4  element. 


NAME 

TYPE/KEY 

DESCRIPTION 

OAFLAG 

2  >  Integer  >  1 

Optimize/analyze  flag 
=1  Optimization 
=2  Analysis 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

BCID 

Integer  >  0 

Boundary  condition  identification  number 

DISC 

Integer  >  0 

Discipline  type 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  number  if  (DISC  = 

1,  3,  5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

String 

Element  type  (“QUAD4”) 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities 
=  2  if  complex  response  quantities 

LAYRNUM 

Integer  >  0 

Layer  number 

CMPZIT 

Integer  >  0 

Composite  type  flag 
=  0  Noncomposite  element 
=  1  Nondesigned  and  nonconstrained 
composite  element 
=  2  Nondesigned  and  constrained 
composite  element 
=  3  Designed  membraine  composite 
element 

=  4  Designed  bending  composite  element 

ESER 

Real 

Real  part  of  element  strain  energy 

ESEI 

Real 

Imaginary  part  of  element  strain  energy 

Z1 

Real 

Fiber  distance  1 

RSTRSXl 

Real 

Real  part  of  normal  stress  in  x-direction  at 

Z1 

ISTRSXl 

Real 

Imaginary  part  of  normal  stress  in  x- 
direction  at  Z1 

RSTRSYl 

Real 

Real  part  of  stress  in  y-direction  at  Z1 
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NAME 


TYPE/KEY 


DESCRIPTION 


ISTRSYl 

Real 

Imaginary  part  of  stress  in  y-direction  at  Z1 

RSSXYl 

Real 

Real  part  of  shear  stress  at  Z1 

ISSXYl 

Real 

Imaginary  part  of  shear  stress  at  Z1  | 

ANGLESl 

Real 

Principal  angle  for  stress  at  Z1 

STRSll 

Real 

Major  principal  stress  at  Z1 

STRS12 

Real 

Minor  principal  stress  at  Z1 

MAXSSl 

Real 

Maximum  shear  stress  at  Z1 

Z2 

Real 

Fiber  distance  2 

RSTRSX2 

Real 

Real  part  of  stress  in  x-direction  at  Z2 

ISTRSX2 

Real 

Imaginary  part  of  stress  m  x-direction  at  Z2 

RSTRSY2 

Real 

Real  part  of  stress  in  y-direction  at  Z2 

ISTRSY2 

Real 

Imaginary  part  of  stress  in  y-direction  at  Z2 

RSSXY2 

Real 

Real  part  of  shear  stress  at  Z2 

ISSXY2 

Real 

Imaginary  part  of  shear  stress  at  Z2 

ANGLES2 

Real 

Principal  angle  for  stress  at  Z2 

STRS21 

Real 

Major  principal  stress  at  Z2 

STRS22 

Real 

Minor  principal  stress  at  Z2 

MAXSS2 

Real 

Maximum  shear  stress  at  Z2 

RSTRNXl 

Real 

Real  part  of  strain  in  x-direction  at  Z1 

ISTRNXl 

Real 

Imaginary  part  of  strain  in  x-direction  at  Z1 

RSTRNYl 

Real 

Real  part  of  strain  in  y-direction  at  Z1  | 

ISTRNYl 

Real 

Imaginary  part  of  strain  in  y-direction  at  Z1 

RSNXYl 

Real 

Real  part  of  shear  strain  at  Z1 

ISNXYl 

Real 

Imaginary  part  of  shear  strain  at  Z1 

ANGLENl 

Real 

Principal  axis  angle  at  Z1 

STRNll 

Real 

Major  principal  strain  at  Z1 

STRN12 

Real 

Minor  principal  strain  at  Z1 

MAXNSl 

Real 

Maximum  shear  strain  at  Z1 

RSTRNX2 

Real 

Real  part  of  strain  in  x-direction  at  Z2 

ISTKNX2 

Real 

Imaginary  part  of  strain  in  x-direction  at  Z2 

RSTRNY2 

Real 

Real  part  of  strain  in  y-direction  at  Z2 

ISTKNY2 

Real 

Imaginary  part  of  strain  in  y-direction  at  Z2 
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Created  By: 
Notes: 


NAME 

TYPE/KEY 

DESCRIPTION 

RSNXY2 

Real 

Real  part  of  shear  strain  at  Z2 

ISNXY2 

Real 

Imaginary  part  of  shear  strain  at  Z2 

ANGELN2 

Real 

Principal  axis  angle  at  Z2 

STKN21 

Real 

Major  principal  strain  at  Z2 

STRJNr22 

Real 

Minor  principal  strain  at  Z2 

MAXSN2 

Real 

Maximum  shear  strain  at  Z2 

RMEMX 

Real 

Real  part  of  membrane  force  in  x-direction 

IMEMX 

Real 

Imaginary  part  of  membrane  force  in  x- 
direction 

RMEMY 

Real 

Real  part  of  membrane  force  in  y-direction 

IMEMY 

Real 

Imaginary  part  of  membrane  force  in  y- 
direction 

RMEMXY 

Real 

Real  part  of  membrane  force  in  xy-plane 

IMEMXY 

Real 

Imaginary  part  of  membrane  force  in  xy- 
plane 

RBENDX 

Real 

Real  part  of  bending  moment  in  x-direction 

IBENDX 

Real 

Imaginary  part  of  bending  moment  in  x- 
direction 

RBENDY 

Real 

Real  part  of  bending  moment  in  y-direction 

IBENDY 

Real 

Imaginary  part  of  bending  moment  in  y- 
direction 

RBENDXY 

Real 

Real  part  of  bending  moment  in  xy-plane 

IBENDXY 

Real 

Imaginary  part  of  bending  moment  in  xy- 
plane 

RSHEARX 

Real 

Real  part  of  shear  force  in  x-direction 

ISHEARX 

Real 

Imaginary  part  of  shear  force  in  x-direction 

RSHEARY 

Real 

Real  part  of  shear  force  in  y-direction 

I SMEARY 

1 _ _ 

Real 

Imaginary  part  of  shear  force  in  y-direction 

Module  EDR 


1.  This  relation  is  used  by  module  OFPEDR  for  printing  and  pimching. 
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Entity: 

Entity  T^pe: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


EOROD 

Relation 

Contains  the  element  response  quantities  for  the  ROD  element. 


NAME 

TYPE/KEY 

DESCRIPTION 

OAFLAG 

2  >  Integer  >  1 

Optimize/analyze  flag 
=1  Optimization 
=2  Analysis 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

BCID 

Integer  >  0 

Boimdary  condition  identification  number 

DISC 

Integer  >  0 

Discipline  t5^e 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Budding 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  number  if  (DISC  = 

1,  3,  5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

string 

Element  type  (“ROD”) 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities 
=  2  if  complex  response  quantities 

ESER 

Real 

Real  part  of  element  strain  energy 

ESEI 

Real 

Imaginary  part  of  element  strain  energy 

RAXSTRS 

Real 

Real  part  of  axial  stress 

lAXSTRS 

;  Real 

Imaginary  part  of  axial  stress 

RTORSTRS 

Real 

Real  part  of  torsional  stress 

ITORSTRS 

Real 

Imaginary  part  of  torsional  stress 

AMARSTRS 

Real 

Axial  stress  margin  of  safety 

TMARSTRS 

Real 

Ibrsional  stress  margin  of  safety 

RAXSTRN 

Real 

Real  part  of  axial  strain 

lAXSTRN 

Real 

Imaginary  part  of  axial  strain 

RTORSTRN 

Real 

Real  part  of  torsional  strain 

ITORSTRN 

Real 

Imaginary  part  of  torsional  strain 

RAXFOR 

Real 

Real  part  of  axial  force 

lAXFOR 

Real 

Imaginary  part  of  gixial  force 

RTORQUE 

Real 

Real  part  of  torsional  force 

ITORQUE 

Real 

Imaginary  part  of  torsional  force 

Module  EDR 

1.  This  relation  is  used  by  module  OFPEDR  for  printing  and  punching. 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


EOSHEAR 

Relation 

Contains  the  element  response  quantities  for  the  SHEAR  element. 


NAME 

TYPE/KEY 

DESCRIPTION 

OAFLAG 

2  >  Integer  >  1 

Optimize/analyze  flag 
=1  Optimization 
=2  Analysis 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

BCID 

Integer  >  0 

Boimdary  condition  identification  number 

DISC 

Integer  >  0 

Discipline  t3rpe 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  number  if  (DISC  = 

1,  3,  5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

String 

Element  type  (“SHEAR”) 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities 
=  2  if  complex  response  quantities 

ESER 

Real 

Real  part  of  element  strain  energy 

ESEI 

Real 

Imaginary  part  of  element  strain  energy 

RMAXSTRS 

Real 

Real  part  of  maximum  shear  stress 

IMAXSTRS 

Real 

Imaginary  part  of  maximum  shear  stress 

RAVESTRS 

Real 

Real  part  of  average  shear  stress 

lAVESTRS 

Real 

Imaginary  part  of  average  shear  stress 

SMARSTRS 

Real 

Stress  safety  margin 

RMAXSTRN 

Real 

Real  part  of  maximum  shear  strain 

IMAXSTRN 

Real 

Imaginary  part  of  maximum  shear  strain 

RAVESTRN 

Real 

Real  part  of  average  shear  strain 

lAVESTRN 

Real 

Imaginary  part  of  average  shear  strain 

RF14 

Real 

Real  part  of  normal  force  on  1  from  4 

IF14 

Real 

Imaginary  part  of  normal  force  on  1  from  4 

RF12 

Real 

Real  part  of  normal  force  on  1  from  2 

IF12 

Real 

Imaginary  part  of  normal  force  on  1  from  2 

RF21 

Real 

Real  part  of  normal  force  on  2  firom  1 

588 


Created  By: 
Notes: 


NAME 

TYPE/KEY 

DESCRIPTION 

IF21 

Real 

Imaginary  part  of  normal  force  on  2  from  1 

RF23 

Real 

Real  part  of  normal  force  on  2  from  3 

IF23 

Real 

Imaginary  part  of  normal  force  on  2  from  3 

RF32 

Real 

Real  part  of  normal  force  on  3  from  2 

IF32 

Real 

Imaginary  part  of  normal  force  on  3  from  2 

RF34 

Real 

Real  part  of  normal  force  on  3  from  4 

IF34 

Real 

Imaginary  part  of  normal  force  on  3  from  4 

RF43 

Real 

Real  part  of  normal  force  on  4  from  3 

IF43 

Real 

Imaginary  part  of  normal  force  on  4  from  3 

RF41 

Real 

Real  part  of  normal  force  on  4  from  1 

IF41 

Real 

Imaginary  part  of  normal  force  on  4  from  1 

RKl 

Real 

Real  part  of  shear  panel  kick  force  at  1 

IKl 

Real 

Imaginary  part  of  shear  panel  kick  force  at 

1 

RS12 

Real 

Real  part  of  shear  force  1-2 

IS12 

Real 

Imaginary  part  of  shear  force  1-2 

RK2 

Real 

Real  part  of  shear  panel  kick  force  at  2 

IK2 

Real 

Imaginary  part  of  shear  panel  kick  force  at 

2 

RS23 

Real 

Real  part  of  shear  force  2-3 

IS23 

Real 

Imaginary  part  of  shear  force  2-3 

RK3 

Real 

Real  part  of  shear  panel  kick  force  at  3 

IK3 

Real 

Imaginary  part  of  shear  panel  kick  force  at  1 
3 

RS34 

Real 

Real  part  of  shear  force  3-4 

IS34 

Real 

Imaginary  part  of  shear  force  3-4 

RK4 

Real 

Real  part  of  shear  panel  kick  force  at  4  I 

IK4 

Real 

Imaginary  pant  of  shear  panel  kick  force  at  j 
4 

RS41 

Real 

Real  part  of  shear  force  4-1  1 

IS41 

Real 

Imaginary  part  of  shear  force  4-1  j 

Module  EDR 


1.  This  relation  is  used  by  module  OFPEDR  for  output  printing  and  punching. 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


EOSUMMRY 

Relation 

Contains  a  summary  of  the  element  output  requests. 


NAME 

TYPE/KEY 

DESCRIPTION 

BCID 

Integer  >  0 

Bormdary  condition  identification  number 

NITER 

Integers  -1 

Iteration  step  for  output  (-1  for  all) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

Tfext  (8) 

Element  type  (example:  “ROD”) 

RECORD 

Integer  >  0 

Record  number  in  EODISC  imstructured 
entity  containing  related  data 

Module  PFBULK 


1. 


For  each  BCID,  the  tuples  are  sorted  by  ETYPE  and  then  EID. 


Entity: 

Entity  TVpe: 
Description: 
Relation  Attributes: 


EOTRIA3 

Relation 

Contains  the  element  response  quantities  for  the  TRIAS  element. 


NAME 

TYPE/KEY 

DESCRIPTION 

OAFLAG 

2  >  Integer  >  1 

Optimize/analyze  flag 
=1  Optimization 
=2  Analysis 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

BCID 

Integer  >  0 

Boundary  condition  identification  number 

DISC 

Integer  >  0 

Discipline  type 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  number  if  (DISC  = 

1,  3,  5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

String 

Element  type  (“TRIAS”) 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities 
=  2  if  complex  response  quantities 

LAYRNUM 

Integer  >  0 

Layer  number 

CMPZIT 

Integer  >  0 

Composite  type  flag 
=  0  Noncomposite  element 
=  1  Nondesigned  and  nonconstrained 
composite  element 
=  2  Nondesigned  and  constrained 
composite  element 
=  3  Designed  membrane  composite 

element  | 

=  4  Designed  bending  composite  element 

ESER 

Real 

Real  part  of  element  strain  energy  1 

ESEI 

Real 

Imaginary  part  of  element  strain  energy  j 

Z1 

Real 

Fiber  distance  1  1 

RSTRSXl 

Real 

Real  part  of  normal  stress  in  x-direction  at  1 
Z1 

ISTRSXl 

Real 

Imaginary  part  of  normal  stress  in  x-  I 

direction  at  Z1  j 

1  RSTRSYl 

Real 

Real  part  of  stress  in  y-direction  at  Z1  j 
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NAME 


TYPE/KEY 


DESCRIPTION 


MAXSSl 


RSTRSY2 

ISTRSY2 


RSSXY2 


ISSXY2 


RSSXYl 

Real 

Real  part  of  shear  stress  at  Zl 

ISSXYl 

Real 

Imaginary  part  of  shear  stress  at  Zl 

ANGLES 1 

Real 

Principal  angle  for  stress  at  Zl 

STRSll 

Real 

Major  principal  stress  at  Zl 

STRS12 

Real 

Minor  principal  stress  at  Zl 

Z2 

Real 

Fiber  distance  2 

RSTRSX2 

Real 

Real  part  of  stress  in  x-direction  at  Z2 

ISTRSX2 

Real 

Imaginary  part  of  stress  in  x-direction  at  Z2 

Real 

Real  part  of  shear  stress  at  Z2 

Real 

Imaginary  part  of  shear  stress  at  Z2 

Maximiim  shear  stress  at  Zl 


Real  part  of  stress  in  y-direction  at  Z2 


Imaginary  part  of  stress  in  y-direction  at  Z2 


ANGLES2 

Real 

Principal  angle  for  stress  at  Z2 

STRS21 

Real 

Major  principal  stress  at  Z2 

STRS22 

Real 

Minor  principal  stress  at  Z2 

MAXSS2 

Real 

Maximum  shear  stress  at  Z2 

RSTRNXl 

Real 

Real  part  of  strain  in  x-direction  at  Zl 

ISTRNXl 

Real 

Imaginary  part  of  strain  in  x-direction  at  Zl 

RSTRNYl 

Real 

Real  part  of  strain  in  y-direction  at  Zl 

ISTRNYl 

Real 

Imaginary  part  of  strain  in  y-direction  at  Zl 

RSNXYl 

Real 

Real  part  of  shear  strain  at  Zl 

ISNXYl 

Real 

Imaginaryl  part  of  shear  strain  at  Zl 

ANGLENl 

Real 

Principal  axis  angle  at  Zl 

STRNll 

Real 

Major  principal  strain  at  Zl 

STRN12 

Real 

Minor  principal  strain  at  Zl 

MAXNSl 

Real 

Maximum  shear  strain  at  Zl 

RSTRNX2 

Real 

Real  part  of  strain  in  x-direction  at  Z2 

ISTKNX2 

Real 

Imaginary  part  of  strain  in  x-direction  at  Z2 

RSTRNY2 

Real 

Real  part  of  strain  in  y-direction  at  Z2 

Imaginary  part  of  strain  in  y-direction  at  Z2 


ISTRNY2 


Created  By: 
Notes: 


NAME 

TYPE/KEY 

DESCRIPTION 

RSNXY2 

Real 

Real  part  of  shear  strain  at  Z2 

ISNXy2 

Reed 

Imaginary  part  of  shear  strain  at  Z2 

ANGELN2 

Real 

Principal  axis  angle  at  Z2 

STRN21 

Real 

Major  principal  strain  at  Z2 

STRN22 

Real 

Minor  principal  strain  at  Z2  j 

MAXSN2 

Real 

Maximmn  shear  strain  at  Z2 

RMEMX 

Real 

Real  part  of  membrane  force  in  x-direction 

IMEMX 

Real 

Imaginary  part  of  membrane  force  in  x-  j 

direction  | 

RMEMY 

Real 

Real  part  of  membrane  force  in  y-direction 

IMEMY 

Real 

Imaginary  part  of  membrane  force  in  y- 
direction 

RMEMXY 

Real 

Real  part  of  membrane  force  in  xy-plane 

IMEMXY 

Real 

Imaginary  part  of  membrane  force  in  xy- 
plane 

RBENDX 

Real 

Real  part  of  bending  moment  in  x-direction 

IBENDX 

Real 

Imaginary  part  of  bending  moment  in  x- 
direction 

RBENDY 

Real 

Real  part  of  bending  moment  in  y-direction 

IBENDY 

Real 

Imaginary  part  of  bending  moment  in  y- 
direction 

RBENDXY 

Real 

Real  part  of  bending  moment  in  xy-plane 

IBENDXY 

Real 

Imaginary  part  of  bending  moment  in  xy- 
plane 

RSHEARX 

Real 

Real  part  of  shear  force  in  x-direction 

ISHEARX 

Real 

Imaginary  part  of  shear  force  in  x-direction 

RSHEARY 

Real 

Real  part  of  shear  force  in  y-direction  j 

ISHEARY 

Real 

Imaginary  part  of  shear  force  in  y-direction  | 

Module  EDR 

1 .  This  relation  is  used  by  module  OFPEDR  for  output  printing  and  pimching. 
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Entity: 

Entity  lype: 
Description: 
Relation  Attributes: 


EOTRMEM 

Relation 

Contains  the  element  response  quantities  for  the  TRMEM  element. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

OAFLAG 

2  >  Integer  >  1 

Optimize/analyze  flag 
=1  Optimization 
=2  Analysis 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

BCID 

Integer  >  0 

Boimdary  condition  identification  number 

DISC 

Integer  >  0 

Discipline  type 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  number  if  (DISC  = 

1,  3,  5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

String 

Element  type  (“TRMEM”) 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities 
=  2  if  complex  response  quantities 

LAYRNUM 

Integer  >  0 

Layer  number 

ESER 

Real 

Real  part  of  element  strain  energy 

ESEI 

Real 

Imaginary  part  of  element  strain  energy 

RSTRSX 

Real 

Real  part  of  normal  stress  in  x-direction 

ISTRSX 

Real 

Imaginary  part  of  normal  stress  in  x- 
direction 

RSTRSY 

Real 

Real  part  of  normal  stress  in  y-direction 

ISTRSY 

Real 

Imaginary  part  of  normal  stress  in  y- 
direction 

RSTRSS 

Real 

Real  part  of  shear  stress 

ISTRSS 

Real 

Imaginary  part  of  shear  stress 

THSTRS 

Real 

Principal  angle  for  stress 

STRSl 

Real 

Major  principal  stress 

STRS2 

Real 

Minor  principal  stress 

MSSTRS 

Real 

Maximum  shear  stress 

RSTRNX 

Real 

Real  part  of  normal  strain  in  x-direction 

594 


Created  By: 
Notes: 


[  NAME 

TYPE/KEY 

DESCRIPTION 

ISTKNX 

Real 

Imaginary  part  of  normal  strain  in  x- 
direction 

RSTRNY 

Real 

Real  part  of  normal  strain  in  y-direction 

ISTRNY 

Real 

Imaginary  part  of  normal  strain  in  y- 
direction 

RSTRNS 

Real 

Real  part  of  shear  strain 

ISTRNS 

Real 

Imaginary  part  of  shear  strain 

THSTRN 

Real 

Principal  angle  for  strain 

STRNl 

Real 

Major  principal  strain 

STRN2 

Real 

Minor  principal  atrain 

MSSTRN 

Real 

Maximum  shear  strain 

RFX 

Real 

Real  part  of  force  in  x-direction 

IFX 

Real 

Imaginary  part  of  force  in  x-direction 

RFY 

Real 

Real  part  of  force  in  y-direction 

IFY 

Reed 

Imaginary  part  of  force  in  y-direction 

RFXY 

Real 

Real  part  of  shear  force  in  xy-plane 

IFXY 

Real 

Imaginary  part  of  shear  force  in  xy-plane 

Module  EDR 

1.  This  relation  is  used  by  module  OFPEDR  for  output  printing  and  punching. 
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Entity: 

Entity  TVpe: 
Description: 

Relation  Attributes: 

Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  IVpe: 
Description: 
Relation  Attributes: 


Created  By: 


EPOINT 

Relation 

Contains  the  identification  numbers  of  those  points  to  be  used  as  extra  points.  Input 
from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Extra  point  set  identification  number 

EXTID 

Integer  >  0 

Extra  point  identification  number 

Module  IFF 

FARGLIST 

Relation 

Contains  the  user  function  argument  list  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

FINDX 

Integer  >  0 

User  function  index  number 

ARGREF 

Integer 

Argument  reference 

IDENT 

TbxtCS) 

Internal  user  function  name 

Module  FPKEVL 

FCHAIN 

Relation 

Contains  the  user  function  chain  evaluation  data  generated  firom  a  lexical  prepass. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

FINDX 

Integer  >  0 

User  function  index  number 

IDENT 

Ifext(8) 

Internal  user  function  name 

NUMTOK 

Integer 

Number  of  tokens 

TOKREF 

Integer 

Token  reference  in  FTOKLIST  and  FDERLIST 

NUMARG 

Integer 

Number  of  arguments 

ARGREF 

Integer 

Argument  reference  in  FARGLIST 

Module  FPKEVL 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


FDERLIST 

Relation 

Contains  the  user  function  packet  token  list  for  function  gradient  evaluation. 


NAME 

TYPE/KEY 

DESCRIPTION 

1  FINDX 

Integer  >  0 

User  function  index  number 

TOKREF 

Integer 

Token  reference 

BAKREF 

Integer 

Back  token  reference 

TOKEN 

Text(8) 

Tbken 

INSCOD 

Tlext(8) 

Instruction  code 

OPCODE 

Integer 

Operator  code 

OPCOMP 

Integer 

Operator  component 

INTVAL 

Integer 

Integer  value 

I  RSPVAL 

Real 

Real  value  j 

Module  FPKEVL 

FDAMPDVA 

Relation 

Contains  the  user  function  requested  flutter  damping  response  sensitivity  mforma- 
tion. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

j  MXCOL 

Integer  >  0 

Matrix  colxmm  number  in  [mxfdpdva]  for  the 
sensitivity  values 

Module  FLUTSENS 


597 


Entity: 

Entity  TVpe: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


FDAMPRSP 

Relation 

Contains  the  user  function  requested  flutter  damping  response  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value 

Module  FLUTTRAN 

FFREQDVA 

Relation 

Contains  the  user  function  requested  flutter  frequency  response  sensitivity  infor¬ 
mation. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

MXCOL 

Integer  >  0 

Matrix  column  number  in  [mxffqdva]  for  the 
sensitivity  values 

Created  By: 


Module  FLUTSENS 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


FFREQRSP 

Relation 

Contains  the  user  function  requested  flutter  frequency  response  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value 

Module  FLUTTRAN 

FLCFDRVA 

Relation 

Contains  the  user  function  requested  steady  aeroelastic  flexible  stability  coefficient 
response  sensitivity  information. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

MXCOL 

Integer  >  0 

Matrix  column  number  in  [MXFCFDVA]  for  the 
sensitivity  values 

Module  AEROEEFS 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes : 


Created  By: 


FLCFRESP 

Relation 

Contains  the  user  function  requested  steady  aeroelastic  flexible  stability  coefficient 
response  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value  | 

Module  SAERO 

FFT 

Relation 

Contains  the  parameters  required  for  controlling  the  Fast  Fourier  Transformation 
as  input  from  the  Bulk  Data  file 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0,  key 

FFT  set  identification  number 

TIME 

Real  >  0 

Length  of  time  period 

NT 

Integer  >  2 

Number  of  time  points 

RDELTF 

Real 

Ratio  of  frequency  range  increment  to 
1/TIME 

RF 

Real 

Ratio  of  frequency  range  to  NT/ 2  *  TIME 

FRIM 

Ifext  (8) 

Frequency  interpolation  method  | 

OTYPE 

Tfext  (8) 

Types  of  response  output  1 

FLIM 

Tfext  (8) 

Frequency  load  interpolation  method  j 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 

Entity: 

Entity  IVpe: 
Description: 

Matrix  Form: 

Created  By; 
Notes: 


FLFACT 

Relation 

Contains  flutter  aerodynamic  input  data  as  defined  on  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

VALUE 

Real 

Data  value  | 

Module  IFP 

1.  This  relation  contains  one  tuple  for  each  value  in  each  set  defined  on  the 
FLFACT  entry. 

FLUTMODE 

Matrix 

A  matrix  used  to  store  the  complex  modal  participation  factors  for  any  flutter 
eigenvectors  computed  during  flutter  analyses  in  analysis  boimdary  conditions. 

A  complex  rectangular  matrix  with  one  row  for  each  normal  mode  (including  those 
omitted  fi-om  the  flutter  analysis)  and  one  column  for  each  flutter  eigenvector  found 
in  the  current  boundary  condition. 

FLUTTRAN 

1.  The  FLUTREL  entity  contains  additional  data  to  identify  the  flutter  condi¬ 
tion  for  each  mode. 

2 .  This  entity  is  flushed  between  each  analysis  boundary  condition  having  flut¬ 
ter  analyses. 

3.  This  entity  is  not  used  in  the  optimization  boundary  conditions. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


FLUTREL 

Relation 

Contains  the  flutter  results  for  each  flutter  eigenvector/eigenvalue  found  during 
flutter  analyses. 


NAME 

TYPE/KEY 

DESCRIPTION 

SUBID 

Integer  >  0 

Flutter  subcase  identification  number 

COLUMN 

Integer  >  0 

Column  number  in  FLUTMODE  for 
corresponding  participation  factors 

MACH 

Real 

Flutter  Mach  number 

RHORATIO 

Real  >  0 

Flutter  density  ratio 

RFRQ 

Real  >  0 

Flutter  reduced  frequency 

VEL 

Real 

Flutter  velocity 

RHOREF 

Real  >  0 

Reference  density 

REFCHORD 

Real  >  0 

Reference  chord  length 

Module  FLUTTRAN 


1.  This  entity  is  used  to  print  the  flutter  mode  shapes  in  physical  coordinates. 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


FLUTTER 

Relation 

Contains  the  definition  of  data  needed  to  perform  flutter  analyses  as  input  from  the 
bulk  data  file. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

SETID 

Integer  >  0 

Set  identification  number 

METHOD 

Tfext(4) 

Flutter  analysis  method  =  PK  or  KE 

DENS 

Integer  >  0 

Identification  of  FLFACT  tuples  defining 
density  ratios 

MACHVAL 

Real  >  0.0 

Mach  number  to  be  used  in  the  Flutter 
analyses 

VEL 

Integer  >  0 

Identification  of  FLFACT  tuples  specifying 
velocities 

MLIST 

Integer 

Identification  number  of  SETl  entries  listing 
the  normal  modes  to  be  omitted  in  the  flutter 
analysis 

KLIST 

Integer 

Identification  of  FLFACT  tuples  specifying  a 
hst  of  “hard  point”  reduced  firequencies  for  the 
given  Mach  number  for  use  in  the  Flutter 
analysis  1 

EFFID 

Integer 

Identification  of  a  CONEFFF  set  specifying 
control  surface  effectiveness  values 

SYMXZ 

Integer 

Symmetry  flag  for  xz-plane 

SYMXY 

Integer 

Symmetry  flag  for  xy-plane 

EPS 

Real 

Convergence  parameter  for  flutter  eigenvalue 

CURVFIT 

Text(8) 

lype  of  curve  fit  to  be  used  in  the  PK  flutter 
analysis 

Created  By: 


Module  IFF 


FNARO 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


Relation 

Contains  the  user  function  instances  requesting  steady  aeroelastic  response  infor¬ 
mation. 


NAME 

TYPE/KEY 

DESCRIPTION 

DCREF 

Integer  >  0 

User  function  set  identification  number 

INSTANCE 

Integer  >  0 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index  in  the  user  function 

CLASS 

Ifext  (16) 

User  function  class 
( OBJECTIVE,  CONSTRAINT) 

BCND 

Integer  >  0 

Boundary  condition  identification  number 

CASEID 

Integer  >  0 

Subcase  identification  number 

TYPE 

Tbxt(8) 

Response  type 

( FLEXCF,  RIGIDCF,  TRIM ) 

AXIS 

Text(8) 

Rigid  body  axis  of  coefficient 

PARAM 

Tfext(8) 

Trim  parameter 

Module  FPKEVL 


1.  The  allowable  values  for  AXIS  are: 

DRAG,  SIDE,  LIFT,  ROLL,  PITCH,  YAW. 

2.  The  allowable  values  for  PARAM  are: 

ALPHA,  BETA,  PRATE,  QRATE,  RRATE,  PACCEL,  QACCEL,  RACCEL, 
and  user  defined  surfaces. 
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Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  lype: 
Description: 
Relation  Attributes: 


Created  By: 


PNCEN 

Relation 

Contains  the  user  function  instances  requesting  element  centroidal  coordinates 
information. 


NAME 

TYPE/KEY 

DESCRIPTION 

DCREF 

Integer  >  0 

User  function  set  identification  number 

INSTANCE 

Integer  >  0 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index  in  the  user  function 

CLASS 

Text (16) 

User  function  class 
( OBJECTIVE,  CONSTRAINT) 

EID 

Integer  >  0 

Element  identification  number 

TYPE 

Tfext(8) 

Element  type 

COMP 

Tfext(4) 

Coordinate  component 
(X1,X2,X3) 

CID 

Integer 

Coordinate  system  identification  number  j 

Module  FPKEVL 

FNCOR 

Relation 

Contains  the  user  function  instances  requesting  grid  point  coordinates  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

DCREF 

Integer  >  0 

User  function  set  identification  number 

INSTANCE 

Integer  >  0 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index  in  the  user  function  I 

1 

CLASS 

Ifext  (16) 

User  function  class 
( OBJECTIVE,  CONSTRAINT) 

GID 

Integer  >  0 

Grid  point  identification  number  | 

CID 

Integer 

Coordinate  system  identification  number 

COMP 

'Ifext(4) 

Coordinate  component 
(XI,  X2,X3) 

Module  FPKEVL 
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FNDNV 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


Relation 

Contains  the  user  function  instances  requesting  global  design  variable  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

DCREF 

Integer  >  0 

User  function  set  identification  number 

INSTANCE 

Integer  >  0 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index  in  the  user  function 

CLASS 

Tbxt (16) 

User  function  clasee 
( OBJECTIVE,  CONSTRAINT) 

DV 

Integer  >  0 

Design  variable  identification  number 

Module  FPKEVL 
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Entity: 

Entity  IVpe: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


FNELM 

Relation 

Contains  the  user  fxmction  instances  requesting  element  stress  and  strain  response 
information. 


NAME 

TYPE/KEY 

DESCRIPTION 

DCREF 

Integer  >  0 

User  function  set  identification  number 

INSTANCE 

Integer  >  0 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index  in  the  user  function 

CLASS 

Itext  (16) 

User  function  class 
( OBJECTIVE,  CONSTRAINT) 

BCND 

Integer  >  0 

Boxmdary  condition  identification  number 

DTYPE 

Text(8) 

Discipline  type  (STATICS,  SAERO)  1 

CASEID 

Integer  >  0 

Subcase  identification  number 

I  MODE ID 

Integer  >  0 

Mode  number 

[EID 

Integer  >  0 

Element  identification  ntimber 

TYPE 

TfextCS) 

Element  type 

PLYID 

Integer  >  0 

Composite  element  layer  number 

QUANTY 

TtextlS) 

Response  tjrpe  (STRESS,  STRAIN) 

1  COMP 

ItextCS) 

Stress/strain  component 

Module  FPKEVL 

1.  The  allowable  stress  components  are: 


ROD 

SIGAXL,  SIGTOR,  SIGl,  SIG2,  MAXSHEAR 

BAR 

SIGAXL,  SIGCA,  SIGDA,  SIGEA,  SIGFA,  SIGCB, 

SIGDB,  SIGEB,  SIGFB 

1  SHEAR 

MAXSHEAR 

1  QDMEM1 

1  TRMEM 

SIGX,  SIGY,  TAUXY,  SIGl,  SIG2,  MAXSHEAR, 

FIBER,  TRANSV 

{  QUAD4 

1  TRIA3 

SIGX,  SIGY,  TAUXY,  SIGl,  SIG2,  MAXSHEAR, 

FIBER,  TRANSV, TSIGX,  TSIGY,  TTAUXY,  TSIGl,  I 

TSIG2,  TMAXSHEAR,  TFIBER,  TTRANSV,  BSIGX, 

BSIGY,  BTAUXY,  BSIGl,  BSIG2 ,  BMAXSHEAR,  1 

BFIBER,  BTRANSV  1 
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2.  The  allowable  strain  components  are: 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


r  ROD 

EPSAXL,  EPSTOR,  EPSl,  EPS2 ,  MAXSHEAR 

BAR 

EPSAXL,  EPSCA,  EPSDA,  EPSEA,  EPSFA,  EPSCB, 
EPSDB,  EPSEB,  EPSFB 

SHEAR 

MAXSHEAR 

QDMEM1 

TRMEM 

EPSX,  EPSY,  TAUXY,  EPSl,  EPS2 ,  MAXSHEAR, 

FIBER,  TRANSV 

QUAD4 

TRIA3 

EPSX,  EPSY,  TAUXY,  EPSl,  EPS2 ,  MAXSHEAR, 

FIBER,  TRANSV, TEPSX,  TEPSY,  TTAUXY,  TEPSl, 
TEPS2,  TMAXSHETUl,  TFIBER,  TTRANSV,  BEPSX, 

BEPSY,  BTAUXY,  BEPSl,  BEPS2 ,  BMAXSHEAR, 

BFIBER,  BTRANSV 

FNFLT 

Relation 

Contains  the  user  function  instances  requesting  flutter  analysis  response  informa¬ 
tion. 


NAME 

TYPE/KEY 

DESCRIPTION 

DCREF 

Integer  >  0 

User  function  set  identification  number  f 

INSTANCE 

Integer  >  0 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index  in  the  user  function 

CLASS 

Text  (16) 

User  function  class 
( OBJECTIVE,  CONSTRAINT) 

BCND 

Integer  >  0 

Boundary  condition  identification  number 

CASEID 

Integer  >  0 

Subcase  identification  number 

MODEID 

Integer  >  0 

Mode  number 

MACH 

Real  >  0.0 

Mach  value 

DENSITY 

Real  >  0.0 

Density  value 

VELOCITY 

Real  >  0.0 

Velocity  value 

QUANTY 

Tsxt(8) 

Response  type 

( FROOT,  FDAMP,  FREQ )  | 

COMP 

TfextCS) 

Damping  component 

Module  FPKEVL 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


FNFRQ 

Relation 

Contains  the  user  function  instances  requesting  normal  mode  frequency  response 
information. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

DCREF 

Integer  >  0 

User  function  set  identification  number 

INSTANCE 

Integer  >  0 

User  function  instance  nxomber 

POSITION 

Integer 

Vector  (2) 

Response  position  index  in  the  user  frmction 

CLASS 

Tfext(16) 

User  function  class 
( OBJECTIVE,  CONSTRAINT) 

BCND 

Integer  >  0 

Boundary  condition  identification  number 

CASEID 

Integer  >  0 

Subcase  identification  number 

MODEID 

Integer  >  0 

Mode  number 

Module  FPKEVL 
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FNGRD 


Entity: 

Entity  IVpe: 
Description: 

Relation  Attributes: 


NAME 

TYPE/KEY 

DESCRIPTION 

DCREF 

Integer  >  0 

User  function  set  identification  number 

INSTANCE 

Integer  >  0 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index  in  the  user  function 

CLASS 

Tfext  (16) 

User  function  class 
( OBJECTIVE,  CONSTRAINT) 

BCND 

Integer  >  0 

Bormdaiy  condition  identification  number 

DTYPE 

Tbxt(8) 

Discipline  type  (STATICS,  SAERO) 

CASEID 

Integer  >  0 

Subcase  identification  number 

MODEID 

Integer  >  0 

Mode  number 

GID 

Integer  >  0 

Grid  point  identification  number 

CID 

Integer 

Coordinate  system  identification  number 

QUANTY 

TfextCS) 

Response  type  (  DISP ) 

COMP 

Ifext(8) 

Displacement  component 

( Tl,  T2,  T3,  Rl,  R2,  R3  ) 

Relation 

Contains  the  user  function  instances  requesting  grid  point  displacement  response 
information. 


Created  By: 


Module  FPKEVL 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


FNMAS 

Relation 

Contains  the  user  function  instances  requesting  element  mass  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

DCREF 

Integer  >  0 

User  function  set  identification  number 

INSTANCE 

Integer  >  0 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index  in  the  user  function 

CLASS 

Tfext  (16) 

User  function  class 
( OBJECTIVE,  CONSTRAINT) 

EID 

Integer  >  0 

Element  identification  number 

TYPE 

Tsxt(8) 

Element  t3rpe 

PLYID 

Integer  >  0 

Composite  element  layer  number  | 

Module  FPKEVL 

FNTHK 

Relation 

Contains  the  user  function  instances  requesting  element  thickness  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

DCREF 

Integer  >  0 

User  fimction  set  identification  number 

INSTANCE 

Integer  >  0 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index  in  the  user  function 

CLASS 

Tfext  (16) 

User  function  class 
( OBJECTIVE,  CONSTRAINT) 

EID 

Integer  >  0 

Element  identification  number  | 

1  TYPE 

Tfext(8) 

Element  type  I 

1  PLYID 

Integer  >  0 

Composite  element  layer  number  | 

Module  FPKEVL 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


FNWGH 

Relation 

Contains  the  user  function  instances  requesting  element  weight  information. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

DCREF 

Integer  >  0 

User  function  set  identification  number  | 

INSTANCE 

Integer  >  0 

User  ftmction  instance  number  | 

POSITION 

Integer 

Vector  (2) 

Response  position  index  in  the  user  function  1 

CLASS 

Text  (16) 

User  function  class  I 

( OBJECTIVE,  CONSTRAINT)  | 

EID 

Integer  >  0 

Element  identification  number 

TYPE 

Tfext(8) 

Element  type  || 

PLYID 

Integer  >  0 

Composite  element  layer  number  | 

Module  FPKEVL 

FORCE 

Relation 

Contains  the  definition  of  a  static  load  at  a  grid  point  as  input  from  the  Bulk  Data 
file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

GRIDl 

Integer  >  0 

Grid  point  at  which  the  load  is  applied 

CIDl 

Integer  >  0 

Coordinate  system  identification 

SCALE 

Real 

Scale  factor  | 

Nl,  N2,  N3 

Real 

Components  of  the  force  vector  | 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


FORCEl 

Relation 

Contains  the  definition  of  aload  applied  at  a  grid  point  with  the  direction  determined 
by  a  line  connecting  two  grid  points. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

GRIDl 

Integer  >  0 

Grid  point  id  at  which  the  force  is  applied 

SCALE 

Real 

Scale  factor 

GRID2,  GRIDS 

Integer  >  0 

Grid  point  identification 

Module  IFP 

FREQ 

Relation 

Contains  frequency  values  to  be  used  for  solution  in  frequency  response. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

SID 

Integer  >  0 

Set  identification  number  1 

FREQ 

Real 

Frequency  value 

Modtde  IFP 

1.  The  relation  is  used  in  subroutine  PREFRQ  in  the  generation  of  the  FREQL 
entity. 

2.  The  unit  for  FREQ  is  Hertz. 

3.  The  set  is  selected  in  Solution  Control. 
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Entity: 

Entity  T^pe: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


FREQl 

Relation 

Contains  information  to  specify  frequencies  used  in  frequency  response  solution  as 
input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0 

Set  identification  number 

FI 

Real  >  0.0 

First  frequency  in  a  set 

DFRQ 

Real  >  0.0 

Frequency  increment 

NDFR 

Integer 

Number  of  increments 

Module  IFF 

1.  The  relation  is  used  in  subroutine  PREFRQ  in  the  generation  of  the  FREQL 
entity. 

2.  Units  for  FI  and  DFREQ,  when  input,  are  Hertz. 

3.  The  set  is  selected  in  Solution  Control. 

FREQ2 

Relation 

Contains  information  to  specify  frequencies  used  in  frequency  response  solution  as 
input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0 

Set  identification  number 

FI 

Real  >  0.0 

First  frequency  value 

F2 

Real  >  0.0,  F2  >  FI 

Last  frequency  value 

NLOGI 

Integer  >  0 

Number  of  increments 

Module  IFF 

1.  The  relation  is  used  in  subroutine  FREFRQ  in  the  generation  of  the  FREQL 
entity. 

2.  Units  for  FI  and  F2,  when  input,  are  Hertz. 

3.  The  set  is  selected  in  Solution  Control. 
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Entity: 

Entity  Type: 
Description: 

Record: 

Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


FREQL 

Unstructured 

Contains  a  list  of  frequencies  for  each  frequency  set. 

1.  Contains  a  list  of  the  LIDs  of  the  frequency  sets  in  the  Bulk  Data  file, 
i.  Contains  the  frequency  list  for  the  (i-1)*"  set  ID. 

Module  PFBULK 

1.  This  entity  is  used  in  the  generation  of  frequency  dependent  loads  in  the 
DMA  module. 

FREQLIST 

Relation 

Contains  the  list  of  frequencies  for  which  outputs  are  requested  as  input  from  the 
Bulk  Data  £Qe. 


NAME 

TYPE/KEY 

DESCRIPTION 

! 

Integer 

Set  identification  number  I 

FREQ 

Real 

Frequency  value  in  Hertz.  | 

Mobile  IFF 

FREQDRVA 

Relation 

Contains  the  user  function  requested  normal  mode  response  sensitivity  information. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

INSTANCE 

Integer 

User  function  instance  number  ! 

POSITION 

Integer 

Vector  (2) 

Response  position  index  ! 

MXCOL 

Integer  >  0 

Matrix  column  number  in  [MXFRQDVA]  for 
the  sensitivity  values  | 

Created  By: 


Module  FREQSENS 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  lype: 
Description: 
Relation  Attributes: 


FREQRESP 

Relation 

Contains  the  user  function  requested  normal  mode  response  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value 

Module  FCEVAL 

FROOTDVA 

Relation 

Contains  the  user  function  requested  flutter  root  response  sensitivity  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

MXCOL 

Integer  >  0 

Matrix  colrnnn  number  in  [MXFRTDVA]  for 
the  sensitivity  values 

Created  By: 


Module  FLUTSENS 


Entity: 

Entity  lype: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


FROOTRSP 

Relation 

Contains  the  user  function  requested  flutter  root  response  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

RVALUE 

Real 

Real  part  of  the  response  value 

IVALUE 

Real 

Imaginary  part  of  the  response  value 

Module  FLUTTRAN 


FTF 

Matrix 

A  matrix  used  in  the  nuclear  blast  response  calculation  to  compute  the  forces  on 
structural  modes  given  the  forces  at  the  aerod5mamic  panels. 

A  real,  rectangular  matrix  with  the  number  of  rows  equal  to  the  number  of 
aerod3mamic  panels. 

MAPOL 

1  yTF  is  computed  using: 

[FTF]  =  [PHIB]^  *  [BLGTJA] 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 
Entity  Type: 
Description: 


Matrix  Form: 

Created  By: 
Notes: 


FTOKLIST 

Relation 

Contains  the  user  function  packet  token  list  for  function  evaluation. 


NAME 

TYPE/KEY 

DESCRIPTION 

FINDX 

Integer  >  0 

User  function  index  number 

TOKREF 

Integer 

Token  reference 

TOKEN 

TfextlS) 

Tbken 

INSCOD 

ItextlS) 

Instruction  code 

OPCODE 

Integer 

Operator  code 

OPCOMP 

Integer 

Operator  component 

INTVAL 

Integer 

Integer  value 

RSPVAL 

Real 

Real  value 

Module  FPKEVL 

GASUBO 

Subscripted  Matrix 
Contains  the  matrix  product: 

-  [KAOO]”^  [KAOA] 

used  in  the  static  reduction  of  the  free  degrees  of  freedom.  This  matrix  includes  the 
aeroelastic  terms. 

A  variable-sized  matrix  having  one  row  for  each  omitted  degree  of  freedom  and  one 
column  for  each  degree  of  freedom  in  the  analysis  set  for  the  current  boundary 
condition. 

MAPOL 

1.  The  dimension  of  this  subscripted  matrix  must  be  large  enough  for  all  optimi¬ 
zation  and  analysis  boundary  conditions. 


Entity: 

Entity  Type- 
Description: 

Relation  Attributes: 

Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


GDVLIST 

Relation 

Contains  the  definition  of  the  fist  of  global  design  variables  as  input  firom  the  Bulk 
Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer 

Set  identification  number 

DVID 

Integer 

Global  design  variable  identification 

Module  IFF 

GDVDRVA 

Relation 

Contains  the  user  function  requested  global  design  variable  sensitivity  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

MXCOL 

Integer  >  0 

Matrix  column  number  in  [MXGDVDVA]  for 
the  sensitivity  values 

Module  GRVGRAD 

GDVRESP 

Relation 

Contains  the  user  function  requested  global  design  variable  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value  f 

Module  GDVRESP 
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Entity: 

Entity  Type: 
Description: 
Entity  Structure: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 


GKNEL 

Unstructured 

Contains  GENEL  data  as  input  from  the  Bulk  Data  file 

One  record  for  each  GENEL  entry  Each  record  has  the  following  structure: 


WORD 

NAME 

DESCRIPTION 

1 

EID 

Element  identification  number 

2 

NGI 

Number  of  GIDI/COMPI  pairs 

3 

NGD 

Number  of  GIDD/COMPD  pairs 

4 

NKZ 

Number  of  NK  or  Z  terms 

5 

"  K"  or  "  Z" 

(Hollerith  indicating  K  or  Z) 

6 

NS 

7  to  6+2  NGI 

GIDI 

COMP  I 

List  of  ui  grid/components.  The 

NGI  pairs  are  the  GIDI/COMPI 
values  (2  NGI  words) 

7+2  to  6+2  NGI 
+2  NGD 

GIDD 

COMPD 

List  of  ud  grid/components.  The 

NGD  pairs  are  the  GIDD/COMPD 
values  (2  NGD  words) 

7+2  NGI +2  NGD  to 
6+2  NGI  +2  NGD 
+  NKZ 

"  K"  or  "  Z" 

List  of  the  NKZ  terms  of  the  “K”  or 
“Z”  matrix 

7+2  NGI  +2  NGD 
+  NKZ  to  END 

s 

List  of  the  NS  terms  of  the  S  matrix 

Any  of  NGI,  NGD,  NKZ  or  NS  can  be  zero  with  the  resultant  list  being  absent  from 
the  record.  The  order  of  terms  will  be  maintained  as  per  the  input  entry. 

Module  IFF 

GENFA 

Matrix 

The  generalized  force  matrix  form  of  the  MATSS  matrix  developed  for  nuclear  blast 
response. 

Real  rectangular  matrix  with  the  number  of  rows  equal  to  the  number  of  modes 
retained  for  the  blast  analysis  and  the  number  of  columns  equal  to  the  number  of 
panels  in  the  unsteady  aerodynamics  model. 

Module  MAPOL 
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6ENF 

Matrix 

The  generalized  matrix  form  of  the  BFRC  matrix  developed  for  nuclear  blast 
response. 

Real  rectangular  matrix  with  the  number  of  rows  equal  to  the  number  of  modes 
retained  for  the  blast  analysis  and  three  columns. 

Module  MAPOL 

Entity:  GENK 

Entity  Type:  Matrix 

Description:  The  generalized  matrix  form  ofthe  KAAmatrix  developed  for  nuclear  blast  response. 

Matrix  Form:  Real  square  matrix  with  the  number  of  rows  equal  to  the  number  of  modes  retained 

for  the  blast  analysis. 

Created  By:  Module  MAPOL 

GENM 

Matrix 

The  generalized  matrix  form  of  the  MAA  matrix  developed  for  nuclear  blast  re¬ 
sponse. 

Real  square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number  of 
modes  retained  for  the  blast  analysis. 

Module  MAPOL 

Entity:  GENQL 

Entity  Type:  Matrix 

Description:  The  generalized  matrix  form  of  the  MATTR  matrix  developed  for  nuclear  blast 

response. 

Matrix  Form:  Real  rectangular  matrix  with  the  munber  of  rows  equal  to  the  number  of  modes 

retained  for  the  blast  analysis  and  the  number  of  columns  equal  to  the  number  of 
panels  in  the  unsteady  aerodynamics  model  times  the  nixmber  of  beta  values  used 
in  the  fitting  process. 

Created  By:  Module  MAPOL 
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Entity: 

Entity  T^pe: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 


6ENQ 

Matrix 

The  generalized  matrix  form  of  the  MATSS  matrix  developed  for  nuclear  blast 
response. 

Real  square  matrix  with  the  number  of  rows  equal  to  the  number  of  modes  retained 
for  the  blast  analysis  and  the  number  of  columns  equal  to  the  number  of  panels  in 
the  unsteady  aerodynamics  model  times  the  number  of  beta  values  used  in  the 
fitting  process. 

Module  MAPOL 

GFE 

Matrix 

A  partition  of  the  GENF  matrix  (see  GENF). 

GFR 

Matrix 

A  partition  of  the  GENF  matrix  (see  GENF). 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


GEOMSA 

Relation 

Contains  data  on  the  geometric  location  of  the  aerodynamic  degrees  of  freedom  for 
the  planar  and  nonplanar  steady  aerodynamics  models. 


NAME 

TYPE/KEY 

DESCRIPTION 

MODEL 

Integer 

Planar  or  nonplanar  steady  aerodynamics 
model  identifier 
=  1  for  planar  model 
=  -  2  for  nonplanar  model 

MACRO ID 

Integer 

Component  identification  number 

ACMPNT 

Text  (8) 

Component  type 

One  of  WING,  FIN,  CANARD.  POD.  or  FUSEL 

NDOF 

Integer 

Number  of  degrees  of  freedom  at  the  point. 

=  1  for  all  steady  aerodynamic  boxes 

refer  to  GEOMUAfor  unsteady  model  options. 

EXTID 

Integer 

External  box  identification  number 

INTID 

Integer 

Internal  box  identification  number.  This  is  the 
row  and/or  column  number  in  the  AICMAT 

AREA 

Real 

The  area  of  the  box. 

X 

Real 

The  X  location  of  the  box  centroid  in  basic 
coordinates. 

Y 

Real 

The  y  location  of  the  box  centroid  in  basic 
coordinates. 

Z 

Real 

The  z  location  of  the  box  centroid  in  basic 
coordinates. 

N1 

Real 

The  X  component  of  the  box  normal  in  basic 
coordinates- 

N2 

Real 

The  y  component  of  the  box  normal  in  basic 
coordinates. 

N3 

Real 

The  z  component  of  the  box  normal  in  basic 
coordinates. 

R1 

Real 

The  X  component  of  the  box  rotation  axis  in 
basic  coordinates. 

R2 

Real 

The  y  component  of  the  box  rotation  axis  in 
basic  coordinates. 

R3 

Real 

The  z  component  of  the  box  rotation  axis  in 
basic  coordinates. 

Module  STEADY  and  STEADYNP 

1.  These  data  are  used  in  splining  the  aerod3mamic  forces  to  the  structural 
model,  in  splining  structural  deflections  to  the  aerodynamic  model  and  in  re¬ 
covering  trimmed  pressures  and  displacements  on  the  aerod5Tiamic  model. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


GEOiyiUA 

Relation 

Contains  data  on  the  geometric  location  of  the  aerod3mamic  degrees  of  freedom  for 
the  imsteady  aerodynamics  models.  Two  entries  are  loaded  for  ZY  boxes  to  account 
for  the  two  normals  during  splining. 


NAME 

TYPE/KEY 

DESCRIPTION 

MACROID 

Integer 

Component  identification  number 

ACMPNT 

Ifext  (8) 

Component  type 

One  of  WING,  FIN,  CANARD,  POD,  or  FUSEL 

NDOF 

Integer 

Number  of  degrees  of  freedom  at  the  point. 

=  1  for  all  lifting  STirface  boxes  CAEROl 
=  2  for  all  body  surface  boxes  CAER02 

EXTID 

Integer 

External  box  identification  number 

INTID 

Integer 

Internal  box  identification  number. 

AREA 

Real 

The  area  of  the  box. 

X 

Real 

The  X  location  of  the  box  centroid  in  basic 
coordinates. 

Y 

Real 

The  y  location  of  the  box  centroid  in  basic 
coordinates. 

Z 

Real 

The  z  location  of  the  box  centroid  in  basic 
coordinates. 

N1 

Real 

The  X  component  of  the  box  normal  in  basic 
coordinates. 

N2 

Real 

The  y  component  of  the  box  normal  in  basic 
coordinates. 

N3 

Real 

The  z  component  of  the  box  normal  in  basic 
coordinates. 

R1 

Real 

The  X  component  of  the  box  rotation  axis  in 
basic  coordinates. 

R2 

Real 

The  y  component  of  the  box  rotation  axis  in 
basic  coordinates. 

R3 

Real 

The  z  component  of  the  box  rotation  axis  in 
basic  coordinates. 

Module  UNSTEADY 
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Entity: 

Entity  lype: 
Description: 

Matrix  Form: 
Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


6G0 


Matrix 

Rigid  body  transformation  matrix  to  transfer  displacements  at  the  origin  of  the  basic 
coordinate  system  to  g-set  displacements. 

Real  rectangular  matrix  with  g-set  rows  and  up  to  six  colxmms. 

Module  GDRl 


6LBDES 

Relation 

Contains  current  design  variable  information  for  all  design  variables  in  the  problem. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

NITER 

Integer 

Iteration  number  1 

DVID 

Integer  >  0,  key 

Design  variable  identification  number 

OPTION 

Integer  1,  2,  3 

Design  variable  linking  option 

LINKID 

Integer 

Link  set  identification 

EID 

Integer  >  0 

Element  id  if  design  variable  uniquely 
linked  to  one  element 

ETYPE 

Text  (8) 

Element  type  if  unique  linking 

LAYRNUM 

Integer 

Laver  number  if  unique  or  physical  linking 

LAYRLST 

Integer 

PLYLIST  identifier  if  multiple  plies  are 
linked  together 

1  DVSYMBL 

'Itext(8) 

Designed  dimension  symbol 
(Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9,  DIO 
for  BAR  element  cross  section 

dimension;  A  for  element  area,  T  for 
element  thickness;  M  for  element  mass;  K  1 
for  element  stifbiess.)  1 

1  VMIN 

Real 

Minimum  value  for  design  variable  j 

VMAX 

Real 

Maximum  value  for  design  variable  I 

VALUE 

Real 

Current  value  of  design  variable  ! 

LABEL 

Tfext  (8) 

User  identification  label  1 

Module  MAKEST 
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Notes: 


1.  The  linking  options  are: 

OPTION  =  1  DESELM  linking 
OPTION  =  2  DESVARP  linking 
OPTION  =  3  DESVARS  linking 

2.  Design  variable  offset  is  stored  in  INFO(ll)  from  MAKEST.  The  value  is 
transferred  to  DVCT  in  the  EMG  module  and  DVCTD,  DDVCT  in  the 
NLEMG  module.  The  offset  is  used  to  generate  pseudo  design  variables  to 
control  the  bending  behavior  of  designed  GEAR  elements. 
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Entity: 
Entity  I^pe: 
Description: 


Matrix  Form: 


Created  By: 
Notes: 


GL6SXG 

Matrix 

Contains  the  stress  and  strain  components  in  the  element  coordinate  system  for 
linearly  designed  elements  constrained  through  stress/strain  constraint  bulk  data 

entries. 

A  variable-size  matrix  having  one  row  for  each  stress/strain  component  for  each 
element  subject  to  a  linear  strength  constraint  and  one  column  for  each  load 
condition  within  each  boundary  condition.  The  order  of  the  matrix  rows  ism 
element  id  order  of  linearly  constrained  elements  within  each  element  type.  The 
element  types  are  currently  processed  in  the  following  order: 

(1)  BAR;  '^al/a2/a3,'^a4,%l.%2,%3,%4 

(2)  QDMEMl;  ®x,  °y,  % 

(3)  QUAD4;  ‘^x,  °y  V 

(4)  ROD;  ®x,Txy 

(5)  SHEAR;  V 

(6)  TRIA3;  ®x,  %  V 

(7)  TRMEM;  ‘^x,  °y,  V 

The  colunms  are  processed  in  load  condition  order  for  each  boundary  condition. 
Module  SCEVAL 

1.  If  no  linearly  designed  elements  are  constrained,  this  matrix  vrill  be  empty. 

2.  Refer  to  the  SMAT  documentation  for  further  details  as  GLBSIG  is  essen¬ 
tially: 

[SMAT]  [Ug] 

3.  Each  boundary  condition’s  load  conditions  are  appended  onto  the  existing 
GLBSIG  columns  within  the  SCEVAL  module. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


GMKCT 

Relation 

Contains  data  required  to  interpret  the  DKVI  unstructured  entity.  The  relation  is 
sorted  by  DVID  and  KSIL. 


NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  identification 

KSIL 

Integer  >  0 

Internal  id  of  grid  or  scalar  point 
connected  to  the  design  variable 

KCODE 

Integer  >  0 

Codeword  denoting  the  form  in  which  the 
DKVT  data  are  stored 

NODES 

Integer  0  <  NODES  < 

20 

Number  of  nodes  being  processed  with 
this  KSIL 

IREC 

Integer  >  0 

Record  number  of  DKVI  entity  where 
data  are  stored 

ASIL 

Ivector  (20) 

List  of  associated  SILS 

ALPHA 

Real 

Exponential  power  associated  with  BAR 
element  design  variable 

Module  NLEMAl 

1.  KCODE  definitions: 

=  1  Multiple  associated  grids  with  both  extensional  and  rotational  degrees 
of  freedom. 

=  2  Column  being  assembled  is  a  scalar  point.  Associated  SILS  may  or 
may  not  be  scalar  points. 

=  3  Column  being  assembled  is  a  grid  point.  At  least  one  row  is  a  scalar 
point. 

=  4  Only  extensional  degrees  of  freedom  are  included  in  the  assembly  proc¬ 
ess 

2.  The  INFO  array  for  this  entity  contains  additional  memory  management  allo¬ 
cation  data: 

INFO(ll)  The  number  of  tuples  connected  to  the  zeroth  design  variable. 

INFO(12)  The  maximum  number  of  tuples  connected  to  any  one  of  the  re¬ 
maining  design  variables. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


GMKCTO 

Relation 

Contains  data  required  to  interpret  the  DKVIO  unstructured  entity.  The  relation  is 
sorted  by  DVID  and  KSIL. 


NAME 

TYPE/KEY 

DESCRIPTION 

1  DVID 

Integer  >  0 

Design  variable  identification 

KSIL 

Integer  >  0 

Internal  id  of  grid  or  scalar  point 
connected  to  the  design  variable 

KCODE 

Integer  >  0 

Codeword  denoting  the  form  in  which  the 
DKVIO  data  are  stored 

NODES 

Integer  0  <  NODES  ^ 
20 

Number  of  nodes  being  processed  with 
this  KSIL 

IREC 

Integer  >  0 

Record  number  of  DKVIO  entity  where 
data  are  stored 

ASIL 

Ivector  (20) 

List  of  associated  SILS 

ALPHA 

Real 

Exponential  power  associated  with  BAR 
element  design  variable 

Module  EMAl 

1.  KCODE  definitions:  ,  ^  i  . 

=  1  Multiple  associated  grids  with  both  extensional  and  rotational  degrees 

of  freedom. 

=  2  Column  being  assembled  is  a  scalar  point.  Associated  SILS  may  or 
may  not  be  scalar  points. 

=  3  Column  being  assembled  is  a  grid  point.  At  least  one  row  is  a  scalar 
point. 

=  4  Only  extensional  degrees  of  freedom  are  included  in  the  assembly  proc¬ 
ess 

2.  The  INFO  array  for  this  entity  contains  additional  memory  management  allo¬ 
cation  data:  1  j  .  •  vi 

INFO(ll)  The  number  of  tuples  connected  to  the  zeroth  design  variable. 

INFO(12)  The  maximum  number  of  tuples  connected  to  any  one  of  the  re¬ 
maining  design  variables. 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


GMKCTG 


Relation 

Contains  data  required  to  interpret  the  DKVIG  unstructured  entity.  The  relation 
is  sorted  by  DVID  and  KSIL. 


NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  identification 

KSIL 

Integer  >  0 

Internal  id  of  grid  or  scalar  point 
connected  to  the  design  variable 

KCODE 

Integer  >  0 

Codeword  denoting  the  form  in  which  the 
DKVIG  data  are  stored 

NODES 

Integer  0  <  NODES  < 
20 

Number  of  nodes  being  processed  with 
this  KSIL 

IREC 

Integer  >  0 

Record  number  of  DKVIG  entity  where 
data  are  stored 

ASIL 

Ivector  (20) 

List  of  associated  SILS 

ALPHA 

Real 

Exponential  power  associated  with  BAR 
element  design  variable 

Module  NLEMAl 


1. 


2. 


KCODE  definitions: 

=  1  Multiple  associated  grids  with  both  extensional  and  rotational  degrees 
of  freedom. 

=  2  Column  being  assembled  is  a  scalar  point.  Associated  SILS  may  or 
may  not  be  scalar  points. 

=  3  Column  being  assembled  is  a  grid  point.  At  least  one  row  is  a  scalar 
point. 

=  4  Only  extensional  degrees  of  freedom  are  included  in  the  assembly  proc¬ 
ess 

The  INFO  array  for  this  entity  contains  additional  memory  management  allo¬ 
cation  data: 


INFO(ll) 

INFO(12) 


The  number  of  tuples  connected  to  the  zeroth 
The  maximum  number  of  tuples  connected  to 
maining  design  variables. 


design  variable, 
any  one  of  the  re- 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


GMMCT 

Relation 

Contains  data  required  to  interpret  the  DMVI  unstructured  entity.  The  relation  is 
sorted  by  DVID  and  KSIL. 


1  NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  identification 

KSIL 

Integer  >  0 

Internal  id  of  grid  or  scalar  point 
connected  to  the  design  variable 

MCODE 

Integer  >  0 

Codeword  denoting  the  form  in  which  the 
DMVI  data  are  stored 

NODES  ^ 

Integer  0  <  NODES  < 

20 

Number  of  nodes  being  processed  with 
this  KSIL 

IREC 

Integer  >  0 

Record  number  of  DMVI  entity  where 
data  are  stored 

ASIL 

Ivector  (20) 

List  of  associated  SILS 

ALPHA 

Real 

Exponential  power  associated  with  BAR 
element  design  variable 

Module  NLEMAl 


1.  MCODE  definitions: 

=  1  Multiple  associated  grids  with  both  extensional  and  rotational  degrees 
of  freedom. 

=  2  Coliimn  being  assembled  is  a  scalar  point.  Associated  SILS  may  or 
may  not  be  scalar  points. 

=  3  Column  being  assembled  is  a  grid  point.  At  least  one  row  is  a  scalar 

point. 

=  4  Only  extensional  degrees  of  freedom  are  included  in  the  assembly  proc¬ 
ess. 

2.  The  INFO  array  for  this  entity  contains  additional  memory  management  allo¬ 
cation  data: 

INFO(ll)  The  number  of  tuples  connected  to  the  zeroth  design  variable. 

INFO(12)  The  maximum  number  of  tuples  connected  to  any  one  of  the  re¬ 
maining  design  variables. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


GMMCTO 

Relation 

Contains  data  required  to  interpret  the  DMVIO  unstructured  entity.  The  relation 
is  sorted  by  DVID  and  KSIL. 


NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  identification 

KSIL 

Integer  >  0 

Internal  id  of  grid  or  scalar  point 
connected  to  the  design  variable 

MCODE 

Integer  >  0 

Codeword  denoting  the  form  in  which  the 
DMVIO  data  are  stored 

NODES 

Integer  0  <  NODES  < 
20 

Number  of  nodes  being  processed  with 
this  KSIL 

IREC 

Integer  >  0 

Record  number  of  DMVIO  entity  where 
data  are  stored 

ASIL 

Ivector  (20) 

List  of  associated  SILS 

ALPHA 

! 

Real 

Exponential  power  associated  with  BAR 
element  design  variable 

Module  EMAl 

1.  MCODE  definitions: 

=  1  Multiple  associated  grids  with  both  extensional  and  rotational  degrees 
of  freedom. 

=  2  Column  being  assembled  is  a  scalar  point.  Associated  SILS  may  or 
may  not  be  scalar  points. 

=  3  Column  being  assembled  is  a  grid  point.  At  least  one  row  is  a  scalar 
point. 

=  4  Only  extensional  degrees  of  freedom  are  included  in  the  assembly  proc¬ 
ess. 

2.  The  INFO  array  for  this  entity  contains  additional  memory  management  allo¬ 
cation  data: 

INFO(ll)  The  number  of  tuples  connected  to  the  zeroth  design  variable. 

INFO(12)  The  maximum  number  of  tuples  connected  to  any  one  of  the  re¬ 
maining  design  variables. 
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Entity: 

Entity  Type- 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


GMMCTD 

Relation 

Contains  data  required  to  interpret  the  DMVID  unstructured  entity.  The  relation 
is  sorted  by  DVID  and  KSIL. 


NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  identification 

KSIL 

Integer  >  0 

Internal  id  of  grid  or  scalar  point 
connected  to  the  design  variable 

MCODE 

Integer  >  0 

Codeword  denoting  the  form  in  which  the 
DMVID  data  are  stored 

NODES 

Integer  0  <  NODES  < 

20 

Nmnber  of  nodes  being  processed  with 
this  KSIL 

IREC 

Integer  >  0 

Record  number  of  DMVID  entity  where 
data  are  stored 

ASIL 

Ivector  (20) 

List  of  associated  SILS 

ALPHA 

Real 

Exponential  power  associated  with  BAR 
element  design  variable 

Module  NLEMAl 

1.  MCODE  definitions: 

=  1  Multiple  associated  grids  with  both  extensional  and  rotational  degrees 
of  freedom. 

=  2  Column  being  assembled  is  a  scalar  point.  Associated  SILS  may  or 

may  not  be  scalar  points. 

=  3  Column  being  assembled  is  a  grid  point.  At  least  one  row  is  a  scalar 
point. 

=  4  Only  extensional  degrees  of  freedom  are  included  in  the  assembly  proc¬ 
ess. 

2.  The  INFO  array  for  this  entity  contains  additional  memory  management  allo¬ 
cation  data: 

INFO(ll)  The  number  of  tuples  connected  to  the  zeroth  design  variable. 

INFO(12)  The  maximum  number  of  tuples  connected  to  any  one  of  the  re¬ 
maining  design  variables. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


GMMCTG 

Relation 

Contains  data  required  to  interpret  the  DMVIG  unstructured  entity  The  relation 
is  sorted  by  DVID  and  KSIL. 


NAME 

TYPE/KEY 

DESCRIPTION 

DVID 

Integer  >  0 

Design  variable  identification 

KSIL 

Integer  >  0 

Internal  id  of  grid  or  scalar  point 
connected  to  the  design  variable 

MCODE 

Integer  >  0 

Codeword  denoting  the  form  in  which  the 
DMVIG  data  are  stored 

NODES 

Integer  0  <  NODES  < 

20 

Number  of  nodes  being  processed  with 
this  KSIL 

IREC 

Integer  >  0 

Record  number  of  DMVIG  entity  where 
data  are  stored 

ASIL 

Ivector  (20) 

List  of  associated  SILS 

ALPHA 

Real 

Exponential  power  associated  with  BAR 
element  design  variable 

Module  NLEMAl 


1. 


2. 


MCODE  definitions: 

=  1  Multiple  associated  grids  with  both  extensional  and  rotational  degrees 
of  freedom. 

=  2  Column  being  assembled  is  a  scalar  point.  Associated  SILS  may  or 
may  not  be  scalar  points. 

=  3  Column  being  assembled  is  a  grid  point.  At  least  one  row  is  a  scalar 
point. 

=  4  Only  extensional  degrees  of  freedom  are  included  in  the  assembly  proc¬ 
ess. 

The  INFO  array  for  this  entity  contains  additional  memory  management  allo¬ 
cation  data: 


INFO(ll) 

INFO(12) 


The  number  of  tuples  connected  to  the  zeroth 
The  maximtun  number  of  tuples  connected  to 
maining  design  variables. 


design  variable, 
any  one  of  the  re- 
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Entity: 

Entity  lype: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


GPFDATA 

Relation 

Contains  the  grid  point  forces. 


NAME 

TYPE/KEY 

DESCRIPTION 

BC 

Integer  >  0 

Boundary  condition  identification  number 

NITER 

Integer  >  0 

Iteration  number  for  optimization 

DISC 

Integer  >  0 

Discipline  t37pe 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer  >  0 

Subcase  identification  number  if  (DISC  =  1,  3, 

5,  8)  or  Mode  Number  if  (DISC  =  2,  7) 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

Tfext(8) 

Element  t3rpe  (example:  “BAR”) 

! 

CMPLX 

Integer  >  0 

Complex  output  identifier 
=  1  if  real  response  quantities 
=  2  if  complex  response  quantities 

SIL 

Integer  >  0 

Internal  grid  point  identification  number 

FLAG 

Integer  >  0 

Flag  indicating  the  point  is  a  grid  point  or  a 
scalar  point 

RFORCE 

Real  vector{6) 

Real  parts  of  force  components 

IFORCE 

Real  vector(6) 

Imaginary  parts  of  force  components 

Module  EDR 


1.  This  relation  is  used  by  module  OFPEDR  for  output  printing  and  punching. 

2.  The  FLAG  equals  6  if  the  point  is  a  grid  point  and  equals  1  if  a  scalar  po’ut 
and  0  if  not  in  the  g-set. 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


6PFELEM 

Relation 

Contains  the  list  of  elements  connected  to  structural  nodes  for  which  grid  point 
forces  have  been  requested. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0 

Set  identification  number  of  GPFORCE  print 
request 

ETYPE 

TtextCS) 

Element  type  (example:  “BAR”) 

EID 

Integer  >  0 

Element  identification  number 

NGRID 

Integer  >  0 

Number  of  grid  points  in  the  element  for  which 
grid  point  forces  are  needed 

ACRID 

Ivector  (32) 

Array  containing  sorted  list  of  GIDs 

Module  PFBULK 

1.  SID  refers  to  the  GRIDLIST  bulk  data  entry  used  in  the  GPFORCE  Solution 
Control  print  request  id  in  Solution  Control. 


Entity; 

Entity  Type; 
Description; 
Entity  Structure; 
Record; 


GPST 

Unstructured 

Contains  the  grid  point  singularity  summary  table. 


1.  There  are  ten  words  for  each  grid  point  component  or  each  scalar  point,  and 
all  of  the  summary  table  are  in  one  record. 

Each  ten  words  are  as  follows; 


1  WORD 

description 

1  ^ 

External  ID  _ _ _ _ _ 

1  ^ 

Type  (  GRID,  SCALAR )  G  or  S  in  hollerith  „ 

1  ^ 

Component  if  grid  point  _ _ _ 

1  4,5,6 

-- 

Singularity  direction  vector _ _ _ _ 

7 

Stiffiiess  ratio 

8 

— - - - - 

Old  set  label 

9 

New  set  label 

10 

Asterisk  or  blank  ( Asterisk  means  USET  updated )  _| 

Created  By; 


GPSP 


GPWGGRID 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


Relation 

Contains  the  definition  of  a  location  for  grid  point  weight  generation  as  input  by  the 
GPWG  data  entry  in  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

GRIDPNT 

Integer 

Grid  point  identification  or  NULL  if 
explicit  location  is  given 

XO 

Real 

X  location  of  the  point 

YO 

Real 

y  location  of  the  point 

ZO  ‘ 

Real 

z  location  of  the  point 

Module  IFP 

1.  GRIDPNT  and  X0,Y0,Z0  are  mutually  exclusive  mechanisms  to  enter  a  loca¬ 
tion 

2.  Only  the  first  tuple  of  GPWGGRID  will  be  used 

3.  If  no  tuples  exist,  the  GPWG  is  performed  at  the  origin  of  the  basic  coordi¬ 
nate  system 


Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


GRADIENT 

Relation 

Contains  the  gradients  of  objective  and  constraint  gradients  requested  to  be  printed 
or  pxmched. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

PRINTKEY 

Integer 

Key  value  referred  to  by  the  CONST  j 

relation 

DVID 

Integer 

Design  variable  identification  number 

GRADIENT 

_ _ 

Real 

Gradient  value  for  the  constraint  in 

CONST  with  the  associated  PRINTKEY 

Module  DESIGN  or  VANGO 


1.  This  entity  contains  one  tuple  for  every  global  design  variable  for  each  tuple 
of  CONST  with  a  nonzero  PRINTKEY  attribute.  That  attribute  points  to  the 
associated  tuples  of  this  entity. 

GRAY 

Relation 

Contains  the  definition  of  the  gravity  vectors  to  be  used  in  applying  gravity  loading 
to  the  model. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

SETID 

Integer  >  0 

Set  identification  number 

CIDl 

Integer  >  0 

Coordinate  system  id  j 

SCALE 

Real 

Scale  factor  I 

Nl,  N2,  N3 

Real 

Components  of  the  gravity  vector  | 

Created  By: 


Module  IFF 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


GRID 

Relation 

Contains  the  geometric  and  permanent  constraint  data  for  a  structural  grid  point 
as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

GRIDID 

Integer  >  0,  key 

The  external  grid  point  id 

CP 

Integer  >  0 

The  coordinate  system  in  which  the 
location  of  the  point  is  defined 

X,  Y,  Z 

Real 

The  location  of  the  grid  point 

CD 

Integer  >  0 

The  id  of  the  coordinate  system  to  be 
used  to  define  displacements, 
constraints,  degrees  of  freedom,  and 
solution  vectors 

PERMSPC 

Integer  >  0 

The  permanent  single  point 
constraints  associated  with  the  grid 
point 

Module  IFF 

GRIDLIST 

Relation 

Contains  the  list  of  grid,  scalar  or  extra  points  for  which  node  dependent  outputs 
are  requested  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer 

Set  identification  number 

GID 

Integer 

External  grid/scalar/extra  point  identification 
number 

Module  IFF 
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Entity: 
Entity  Type; 
Description: 

Record: 


Created  By: 
Notes: 

Entity; 

Entity  Type: 
Description: 

Entity: 

Entity  lype: 
Description: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


6RIDTEMP 

Unstnictxired 

Contains  temperature  data  for  all  grid  and  scalar  points  for  all  thermal  load  sets 

defined. 

1.  A  list  of  all  set  identification  numbers  in  sorted  order. 

i.  Contains  the  grid  and  scalar  point  temperatures  for  the  (i-l)th  specified  ther¬ 
mal  load  case.  The  storage  order  of  temperatme  data  within  each  record  fol¬ 
lows  the  ordering  of  KSIL  values  in  the  BGPDT  table  with  extra  points 
excluded. 

PFBULK 

1.  This  entity  is  used  in  EMG  to  compute  average  element  temperatures  and  is 
used  in  LODGEN  to  compute  the  global  thermal  load  sensitivity  vectors. 


GSKF 

Matrix 

The  transpose  of  GSTK[F  (see  GSTKG). 


GSTKF 

Matrix 

A  partition  of  the  GSTKN  matrix  (see  GSTKG) 


GSTKG 

Matrix 

The  interpolation  matrix  relating  slopes  in  the  streamwise  direction  at  the  aerody¬ 
namic  degrees  of  freedom  to  the  displacements  at  the  global  structural  degrees  of 
freedom. 

A  variable-sized  matrix  having  one  column  for  each  steady  aerodynamic  box  and 
one  row  for  each  structural  degree  of  freedom. 

Module  SPLINES 


1.  The  MAPOL  sequence  supports  the  following  partitions  of  the  GSTKG  matrix 
(see  the  Theoretical  Manual  for  the  explicit  formation  of  these  submatrices): 


GSTKG 


GSTKN 


<P 

GSTKN 


GSTKF 
T 


GSKF  =  [GSTKF  ] 
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Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


6STKN 

Matrix 

A  partition  of  the  GSTKG  matrix  (see  GSTKG). 

GSUBO 

Subscripted  Matrix 
See  Notes. 

A  variable-sized  matrix  with  one  row  for  each  omitted  degree  of  freedom  and  one 
column  for  each  degree  of  freedom  retained  for  analysis.  The  precision  of  this  matrix 
is  the  same  as  that  of  the  KGG  matrix. 

MAPOL 


1.  For  Guyan  reduction  GSUBO  contains  the  matrix  product 

-  [KOO]  [KOA] 

2.  If  no  omitted  degrees  of  freedom  are  defined  for  the  model,  GSUBO  will  be  in¬ 
itialized. 

3.  For  generalized  dynamic  reduction,  GSUBO  relates  degrees  of  freedom  in  the 
f-  to  q-  set  (union  of  a-,  k-,  and  j-sets)  degrees  of  freedom. 

GTKF 

Matrix 

A  partition  of  the  GTKN  matrix  (see  GTKN). 

GTKG 

Matrix 

The  interpolation  matrix  relating  the  forces  at  the  aerod3mamic  degrees  of  freedom 
to  the  forces  at  the  global  structural  degrees  of  freedom. 

A  variable-sized  matrix  having  one  column  for  each  steady  aerodynamic  degree  of 
freedom  (box)  and  one  row  for  each  structural  degree  of  freedom. 

Module  SPLINES 


1.  The  MAPOL  sequence  creates  the  following  partitions  of  the  GTKG  matrix 
(see  the  Theoretical  Manual  for  the  explicit  formation  of  these  submatrices): 


GTKG 


9 

GTKN 


GTKN 


<P 

GTKF 
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Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


GTKN 

Matrix 

A  partition  of  the  GTKG  matrix  (see  GTKG). 


GUST 


Relation 

Contains  vertical  gust  data  for  a  gust  analysis  as  input  from  the  bulk  data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Inteeer  >  0 

Gust  set  ID 

GLOAD 

Integer  >  0 

ID  of  an  entry  which  defines  time  or  frequency 
dependent  loads. 

WG 

Real  >  0.0 

Scale  factor  for  gust  velocity 

XO 

Real  >  0.0 

Location  of  reference  plane  in  aerodynamic 
coordinates 

V 

Real  >  0 

Velocity  of  the  vehicle 

QDP 

Real  >  0 

Dynamic  pressure  of  the  vehicle 

MACH 

Real  >  0.0 

Mach  number  of  the  vehicle 

SYMXZ 

Integer 

Svmmetrv  flag  for  xz-plane 

SYMXY 

Integer 

Symmetry  flag  for  xy-lane 

Module  IFF 


lARGLXST 

Relation 

Contains  the  resolved  user  function  argument  list  information. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

INSTANCE 

Integer  >  0 

User  function  instance  number 

FINDX 

Integer  >  0 

User  function  index  number 

ARGREF 

Integer 

Argument  reference  I 

IDENT 

Text(8) 

I  ^ 

Internal  function  name 

TYPE 

Integer 

Argument  type 

INTVAL 

Integer 

Integer  value 

RSPVAL 

Real 

Real  value  1 

Module  FPKEVL 
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Entity: 

Entity  T^pe: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  TVpe: 
Description: 

Entity  Structure: 
Record: 


Created  By: 
Notes: 


IC 

Relation 

Contains  the  values  of  initial  displacements  and  velocities  for  use  in  direct  transient 
response  analysis  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer 

Set  identification  number 

GRID 

Integer 

Grid,  scalar  or  extra  point  identification 
niunber 

COMP 

Integer 

Grid  point  component  number 

UO 

Real 

Initial  displacement  value 

VO 

Real 

Initial  velocity  value 

Module  IFF 

ICDATA 

Unstructured 

Contains  the  collection  of  initial  condition  data  for  all  initial  condition  sets  refer¬ 
enced  in  Solution  Control. 


1.  A  list  of  all  set  identtScation  numbers  in  sorted  order. 

i.  Contains  the  initial  conditions  for  the  (i-1)^^  initial  condition  set.  Each  record 
has  the  following  form: 


1 

WORD 

VARIABLE 

DESCRIPTION  1 

1 

SID 

Set  identification 

j 

ROW 

Internal  number  of  the  degree  of  freedom  affected 
by  the  initial  condition  in  increasing  Row  order 

j+1 to j+2 

For  each  degree  of  freedom  two  words  are  stored: 

(1)  initial  displacement 

(2)  initial  velocity 

PFBULK 

1.  This  entity  is  used  in  DMA  to  assemble  the  ICMATRK  entity  for  the  bound¬ 
ary  condition. 

2.  The  j  index  nms  from  2  to  3  *  NROW  by  3  for  each  degree  of  freedom  in  the 
model  that  has  a  nonzero  initial  condition. 
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Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 
Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


ICMATRIX 

Matrix 

Contains  the  matrix  of  transient  response  initial  conditions  in  the  d-set  for  the 
current  boundary  condition. 

A  variable-sized  rectangular  matrix  having  one  row  for  each  degree  of  freedom  in 
the  d-set  and  two  columns  for  each  transient  response  subcase.  The  first  colimn  is 
the  vector  of  initial  displacement  and  the  second  is  the  vector  of  initial  velocity. 

DMA 

1.  This  entity  will  be  flushed  for  each  boundary  condition  having  dynamic  re¬ 
sponse  disciplines. 

ID2 

Matrix 

An  identity  matrix  required  in  the  MAPOL  sequence  associated  with  the  nuclear 
blast  response. 

A  2  by  2  identity  matrix. 

Module  BLASTFIT 

IFM 

Subscripted  Matrix 

Intermediate  matrix  in  the  reduction  of  the  mass  matrix  for  unrestrained  boundary 
conditions. 

The  number  of  rows  is  equal  to  the  number  of  degrees  of  freedom  in  the  o-set  while 
the  number  of  columns  is  equal  to  the  number  of  degrees  of  freedom  in  the  a-set. 

MAPOL 

1.  If  there  are  no  aerodynamics,  IFM  is  computed  from  MOO  times  GSUBO 

2.  If  there  are  aerodynamics,  IFM  is  computed  from  MOO  times  GASUBO  plus 

MOA.  .  .  ^  ^  ,  V  u  .1 

3.  Since  IFM  is  required  in  the  sensitivity  analysis,  it  is  subscripted  by  bouna- 

ary  condition  number. 
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Entity: 

Entity  lype: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


IPR 

Subscripted  Matrix 

Intermediate  matrix  in  the  reduction  of  the  mass  matrix. 

The  number  of  rows  is  equal  to  the  number  of  degrees  of  freedom  in  the  1-set  while 
the  number  of  colimms  is  equal  to  the  nvunber  of  degrees  of  freedom  in  the  r-set. 

MAPOL 

1.  IFR  is  computed  as  MLL  times  D  plus  MLR. 

2.  Since  IFS  is  required  in  the  sensitivity  anaysis,  it  is  subscripted  by  boimdary 
condition  number. 

IHEXIEST 

Relation 

Contains  the  element  summary  data  for  the  linear  isoparametric  hexahedron 
element. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

SILi  i=l,  .  .  .8 

Integer  >  0 

Internal  grid  points  identification 
numbers 

COORDi  i=l, . .  .8 

Integer  >  0 

External  coordinate  system 
identification  number  for 
displacements  at  SILi 

Xi  i=l,  ...  8 

Real 

Basic  coordinates  of  SILi 

Yi  i=l,  .  .  .8 

Real 

Zi  i=l,  .  .  .8 

Real 

MID 

Integer  >  0 

Material  identification  number 

CID 

Integer  >  0 

Coordinate  system  identification 
number  in  which  anisotropic  material 
is  defined. 

NIP 

Integer 

Number  of  integration  points  in  each 
coordinate  direction 

AR 

Real 

Maximum  aspect  ratio  of  element 

ALFA 

Real 

Maximum  angle  (degrees)  for  face 
normals 

BETA 

_ 

Real 

Maximum  angle  (degrees)  for  mid¬ 
edge  points  I 

Module  MAKEST 

1.  This  relation  is  built  from  the  CIHEX,  the  PIHEX  and  the  basic  grid  point  re¬ 
lations.  It  contains  one  tuple  for  each  linear  isoparametric  hexahedron  ele¬ 
ment  in  the  problem. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


IHEX2EST 

Relation 

Contains  the  element  summary  data  for  the  quadratic  isoparametric  hexahedron 
element. 


NAME 

TYPE/KEY 

DESCRIPTION 

1  EID 

Integer  >  0,  key 

Element  identification  number 

SILS 

Ivector  (20) 

Internal  grid  point  identification 
numbers 

COORDi  i=l, . . .20 

Integer  >  0 

External  coordinate  system 
identification  number  for 
displacements  at  SILSi 

Xi  i=l, . . .20 

Rvector  (3) 

Basic  coordinates  of  SILSi 

MID 

Integer  >  0 

Material  identification  number 

CID  ’ 

Integer  >  0 

Coordinate  system  identification 
number  in  which  anisotropic 
material  is  defined 

NIP 

Integer  =  2,3,4 

Number  of  integration  points  in 
each  coordinate  direction 

AR 

Real 

Maximum  aspect  ratio  of  element 

ALFA 

Real 

Maximum  angle  (degrees)  for  face 
normals  I 

BETA 

Real 

Maximum  angle  (degrees)  for  mid-  | 
edge  points  1 

Module  MAKEST 

1 .  This  relation  is  built  from  the  CfflEX,  the  PIHEX,  and  the  basic  grid  point  re¬ 
lations.  It  contains  one  tuple  for  each  quadratic  isoparametric  hexahedron 
element  in  the  problem. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

SILS 

Ivector  (32) 

Internal  grid  point  identification 
numbers 

COORDi  i=l, . . .32 

Integer  >  0 

External  coordinate  system 
identification  number  for 
displacements  at  SILSi 

Xi  i=l,  . .  .32 

Rvector  (3) 

Basic  coordinates  of  SILSi 

MID 

Integer  >  0 

Material  identification  number 

CID 

Integer  >  0 

Coordinate  system  identification 
nmnber  in  which  anisotropic 
material  is  defined 

NIP 

Integer 

Number  of  integration  points  in 
each  coordinate  direction 

AR 

Real 

Maximum  aspect  ratio  of  element 

ALFA 

Real 

Maximum  angle  (degrees)  for  face 
normals 

BETA 

Real 

Maximum  angle  (degrees)  for  mid¬ 
edge  points 

IHEX3EST 

Relation 

Contains  the  element  summary  data  for  the  cubic  isoparametric  hexahedron  ele¬ 
ment. 


Created  By:  Module  MAKEST 

Notes: 

1.  This  relation  is  built  from  the  CIHEX,  the  PIHEX,  and  the  basic  grid  point  re¬ 
lations.  It  contains  one  tuple  for  each  quadratic  isoparametric  hexahedron 
element. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


ITERLIST 

Relation 

Contains  the  definition  of  the  list  of  design  iterations  as  input  from  the  Bulk  Data 
file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer 

Set  identification  number 

NITER 

Integer 

Design  iteration  number  _ 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

.  Relation  Attributes: 


Created  By: 
Notes: 


JOB 

Relation 

Contains  the  case-independent  solution  control  parameters  as  input  in  the  solution 
control  packet. 


NAME 

TYPE/KEY 

DESCRIPTION 

AIRFPRNT 

Integer 

vector 

(20) 

Airfoil  shape  print  selection 

WORD  1  Print  set  identification  number  >  0,  or 
=  0  NONE 
=  -lALL 
=  -2LAST 

WORD  2  Pimch  set  identification  number 

WORD  3  Print  form 
=  0  Rectangular 
=  1  Polar 

WORD  4  Pimch  form 

WORD  5  Print  frequency  set  identification  number 
WORD  6  Punch  frequency  set  identification  number 
WORD  7  Print  iteration  set  identification  number 
WORD  8  Punch  iteration  set  identification  number 
WORD  9  Print  mode  set  identification  number 
WORD  10  Punch  maode  set  identification  number 
WORD  11  Print  time  set  identification  number 
WORD  12  Punch  time  set  identification  number 
WORD  13-20  unused 

PLANPRNT 

Integer 

vector 

(20) 

Planform  print  selection 

PRESPRNT 

Integer 

vector 

(20) 

Unit  pressure  coefficient  print  selection 

TITLE 

Itext  (72) 

User  label  TITLE 

SUBTITLE 

Tfext  (72) 

User  label  SUBTITLE 

LABEL 

Itext  (72) 

User  label  LABEL 

Module  Solution 

1.  The  format  of  the  AIRFPRNT  vector  is  typical  of  the  format  of  all  the  print  se¬ 
lection  vectors.  Additionally,  the  format  for  the  print  set  Identification  num¬ 
ber  in  the  AIRFPRNT  vector  is  t3rpical  of  that  of  the  other  set  Identification 
numbers  in  the  vector. 

2.  The  CASE,  JOB  and  OPTIMIZE  relation  entities  together  contain  the  solu¬ 
tion  control  requests  as  input  in  the  solution  control  packet.  CASE  contains 
the  case-dependent  parameters,  JOB  contains  the  case-independent  requests 
and  OPTIMIZE  contains  the  optimization-dependent  requests. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity: 

Description: 

Relation  Attributes: 


Created  By: 
Notes: 

Entity: 
Entity  Type: 
Description: 


JSET 

Relation 

Contains  the  external  grid  identification  numbers  and  components  with  the  analysis 
set  as  defined  on  the  JSET  entries  of  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

JSET  identification  number 

1  GRIDl 

Integer  >  0 

Grid  or  Scalar  point  id 

COMPNTS 

Integer  >  0 

Component  niimber: 

=  0  for  scalar  points 

=  1-6  for  grid  points 

Module  IFP 

1.  Used  by  the  MKUSET  Module  to  build  the  USET  relation. 

JSETl 

Relation 

Contains  the  external  grid  identification  numbers  and  components  associated  with 
the  analysis  set  as  defined  on  the  JSETl  entries  of  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

JSET  identification  number 

COMPNTS 

Integer  >  0 

Component  number: 

=  0  for  scalar  points 

=  1-6  for  grid  points 

GRIDl 

Integer  >  0 

Grid  or  Scalar  point  id 

Module  IFP 

1.  Used  by  the  MKOSET  Module  to  build  the  USET  relation. 

KAA 

Matrix 

Partition  of  the  KFF  matrix  (see  KGG). 
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Entity: 

Entity  TVpe: 
Description: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 

Entity: 
Entity  lype: 
Description: 

Entity: 
Entity  Type: 
Description: 


KAAA 

Matrix 

Partition  of  the  KAFF  matrix  (see  KAFF). 


KAFF 

Matrix 

Contains  the  stiffiiess  matrix  for  the  free  degrees  of  freedom  in  the  current  boimdary 
condition  including  the  aeroelastic  terms. 

A  variable-sized  asymmetric  matrix  having  one  row  and  one  column  for  each  free 
degree  of  freedom  in  the  current  boundary  condition. 

MAPOL 


1.  The  matrix  is  formed  using 

[  KAFF  ]  =  [  KAFF  ]  “  «  [  AICS  ] 


2. 


The  MAPOL  sequence  supports  the  following  partitions  of  the  KAFF  matrix 
(see  the  Theoretical  Manual  for  the  explicit  formation  of  these  submatrices): 


KAFF 


KAAA 


9 

KAO 

KAKK 

KALR 


<P  1 

KAAA  I 

KARL  1 
KALL 


KALL 

Matrix 

Partition  of  the  KAAA  matrix  (see  KAFF). 

KALR 

Matrix 

Peutition  of  the  KAAA  matrix  (see  KAFF). 

KAO 

Matrix 

Partition  of  the  KAFF  matrix  (see  KAFF). 

KARL 

Matrix 

Partition  of  the  KAAA  matrix  (see  KAFF). 
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Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 

Entity: 
Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 


KARR 

Matrix 

Partition  of  the  KAAA  matrix  (see  KAFF). 

KDDF 

Matrix 

Sti£&iess  matrix  in  the  direct  set  used  in  frequency  response  analysis. 

Complex  square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number 
of  degrees  of  freedom  in  the  d-set. 

DMA 

KDDT 

Matrix 

Stif&iess  matrix  in  the  direct  set  used  in  frequency  response  analysis. 

Complex  square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number 
of  degrees  of  freedom  in  the  d-set. 

DMA 

KEE 

Matrix 

Apartition  of  the  GENK  matrix  that  contains  only  elastic  degrees  of  freedom.  Used 
in  the  nuclear  blast  response  analysis. 

Complex  square  matrix  with  the  nmnber  of  rows  and  columns  equal  to  the  number 
of  elastic  modes  retained  for  the  blast  analysis. 

MAPOL 
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Entity: 

Entity  Type: 
Description: 

Entity  Structure: 
Record: 


Created  By: 
Notes: 


KELM 

Unstructured 

Contains  the  matrix  partitions  of  the  element  nondesign  stifftiess  and  linear  design 
stiffiiess. 


i.  If  the  element  is  a  scalar  element: 

the  record  contains  the  components  of  the  connected  grid  point(s)  (if 
any)  and  the  value  K. 


KCODE 

FORMAT  OF  RECORD 

1 

K 

2 

COMPl,  0,  -i-K,  -+K 

3 

0,  COMPl,  +-K,  -+K 

4 

+-K,-+K 

5 

COMPl,  0,  K 

6 

COMPl,  COMP2,  +-K,  -+K 

Else 

the  record  contains  a  partition  of  the  stif&iess  matrix  with  either  1,  3, 
or  6  entries  for  each  node 


KCODE 

FORMAT  OF  RECORD 

7 

3  columns  of  3  entries/node 

8 

3  columns  of  3  entries/node 

9 

6  columns  of  6  entries/node 

Module  EMG 

1.  This  entity  contains  one  record  for  each  strip  of  each  element  stifi&iess  ma¬ 
trix.  A  strip  or  partition  is  defined  as  aU  those  columns  of  the  element  matrix 
associated  with  a  pivot  sil  (the  id  of  the  first  DOF  of  a  grid  point  or  the  id  of  a 
scalar  point). 

2.  Refer  to  the  DVCT  relation  for  further  details,  as  these  two  data  base  entities 
are  closely  linked. 

3.  The  matrix  partitions  are  stored  in  the  same  precision  as  the  KGG  matrix. 

4.  The  records  related  to  nonlinear  design  stiffiiess  are  empty. 

5.  KELM  and  DKELM  are  used  to  generate  all  of  the  element  stiffiiess  sensitiv¬ 
ity  matrix  partitions. 

6.  KELM  and  KELMD  are  used  to  generate  all  of  the  element  stiffiiess  sensitiv¬ 
ity  matrix  partitions. 
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Entity; 

Entity  TVpe: 
Description: 
Entity  Structure: 
Record: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 

Entity: 
Entity  Type: 
Description: 


KELMD 

Unstructured 

Contains  the  element  nonlinear  design  stif&iess  matrix  partitions. 


the  record  contains  a  partition  of  the  stif&iess  matrix  with  either  1,  3,  or  6  en- 
tries  for  each  node 


KCODE 

FORMAT  OF  RECORD  | 

7 

3  columns  of  3  entries/node 

8 

3  columns  of  3  entries/node 

9 

6  columns  of  6  entries/node 

Module  EMG 

1.  This  entity  contains  one  record  for  each  strip  of  each  element  nonlinear  de- 
sign  stiffness  matrix.  A  strip  or  partition  is  defined  as  all  those  columns  of 
the  element  matrix  associated  with  a  pivot  sil  (the  id  of  the  first  DOF  of  a 
grid  point  or  the  id  of  a  scalar  point). 

2.  Refer  to  the  DVCTD  relation  for  further  details,  as  these  two  data  base  enti¬ 
ties  are  closely  linked. 

3.  The  matrix  partitions  are  stored  in  the  same  precision  as  the  KGG  matrix. 

A.  KELMD  and  KELM  are  used  to  generate  all  of  the  element  stif&iess  sensitiv¬ 
ity  matrix  partitions. 


KEQE 

Matrix 

Structural  plus  aerodynamic  stiffiiess  matrix  for  the  elastic  modes  retained  in  the 
blast  response  analysis. 

Complex  square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number 
of  elastic  modes  retained  for  the  blast  analysis. 

MAPOL 

1.  KEQE  is  obtained  from  [KEQE]  =  [KEE]  +  [QEE] 

KFF 

Matrix 

Partition  of  the  KNN  matrix  (see  KGG). 


655 


Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


KFS 

Matrix 

Partition  of  the  KNN  matrix  (see  KGG). 

K66 

Matrix 

Contains  the  current  global  stifi6iess  matrix  for  the  design  problem. 

A  variable-size  symmetric  matrix  having  one  row  and  one  column  for  each  structural 
degree  of  freedom  in  the  problem. 

Module  MAPOL 

1.  The  KGG  matrix  is  formed  in  the  second  phase  stiffiiess  matrix  assembly. 

2.  The  MAPOL  sequence  supports  the  following  partitions  of  the  KGG  matrix 
(see  the  Theoretical  Manual  for  the  exphcit  formation  of  these  submatrices): 

cp  <p 

(p  KNN 

KSS  (p 

KFS  KNN 

KOO*  KOA* 

9  KAA 

<p  <p 

KLR  KLL 

*  Generalized  dynamic  reduction  only 

KHHF 

Subscripted  Matrix 

Stifftiess  matrix  in  the  modal  set  used  in  frequency  response  and  flutter  analyses. 

Complex  square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number 
of  degrees  of  freedom  in  the  h-set. 

DMA 

1.  The  matrix  may  be  required  in  the  flutter  sensitivity  analysis  and  is  there¬ 
fore  subscripted  by  boundary  condition. 


KGG  -> 

KNN 

KFF  -> 

KAA 
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Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 
Created  By: 
Notes: 


KHHT 

Subscripted  Matrix 

Stiffness  matrix  in  the  modal  set  used  in  transient  response  analysis. 

Complex  square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number 
of  degrees  of  freedom  m  the  h-set. 

DMA 

KLL 

Matrix 

Partition  of  the  KAA  matrix  (see  KGG). 

KLLINV 

Subscripted  Matrix 

Contains  the  upper  and  lower  triangular  sections  of  the  [KLL]  symmetric  stif&iess 
matrix. 

A  variable-sized  matrix  having  one  row  and  one  column  for  each  dep-ee  of  freedom 
left  over  for  analysis  after  partition/reduction.  The  precision  of  this  matrix  is  the 
same  as  the  KGG  matrix. 

SDCOMP 

1.  This  matrix  is  formed  for  use  by  the  FBS  utility. 

KLLL 

Matrix 

Contains  the  lower  triangular  portion  of  the  decomposed  Ki^y^  matrix.  Note  that 
KAAA  is  asymmetric  requiring  use  of  the  general  decomposition  routine. 

Refer  to  the  DECOMP  utility  documentation. 

DECOMP 

1.  This  matrix  is  formed  to  be  used  in  the  general  forward  backward  substitu¬ 
tion  module  GFBS. 
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Entity: 

Entity  Type: 
Description: 

Matrix  Form: 
Created  By: 
Notes: 


Entity: 

Entity  lype: 
Description: 

Entity: 

Entity  lype: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 
Entity  lype: 
Description: 


KLLU 

Matrix 

Contains  the  upper  triangular  portion  of  the  decomposed  partition  of  the  KAAA 
matrix.  Note  that  KAAA  is  asymmetric  requiring  use  of  the  general  decomposition 
routine. 

Refer  to  the  DECOMP  utility  documentation. 

DECOMP 

1.  This  matrix  is  formed  to  be  used  in  the  general  forward  backward  substitu¬ 
tion  module  GFBS. 

KLR 

Matrix 

A  partition  of  the  KAA  matrix  (see  KGG). 

KLll 

Subscripted  Matrix 

Lower  triangular  portion  of  the  decomposed  Kll  matrix. 

Square  real  matrix  having  one  row  and  one  column  for  each  a-set  degree  of  freedom. 
DECOMP 

1.  Kll  is  not  symmetric. 

2.  This  matrix  is  formed  for  use  by  the  GFBS  utility. 

3.  The  matrix  may  be  required  in  the  sensitivity  analysis  and  is  therefore  sub¬ 
scripted  by  boundary  condition. 

KNN 

Matrix 

A  partition  of  the  KGG  matrix  (see  KGG). 
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Entity: 

KOA 

Entity  lype: 

Matrix 

Description: 

A  partition  of  the  KFF  matrix  used  in  Generalized  Dynamic  reduction. 

Matrix  Form: 

Real  rectangular  matrix  with  one  row  for  each  o-set  degree  of  freedom  and  one 
column  for  each  a-set  degree  of  freedom. 

Created  By: 

PARTN 

Notes: 

1.  This  matrix  is  required  only  for  generalized  dynamic  reduction  and  only 
when  the  user  has  specified  a-set  degrees  of  freedom. 

Entity: 

KOO 

Entity  Type: 

Matrix 

Description: 

A  partition  of  the  KFF  matrix  used  in  Generalized  Dynamic  reduction. 

Matrix  Form: 

Real  squar  matrix  with  one  row  for  each  o-set  degree  of  freedom. 

Created  By: 

Notes: 

PARTN 

1.  This  matrix  is  required  only  for  generahzed  dynamic  reduction. 

2. 

If  the  user  has  not  specified  a-set  degrees  of  freedom,  KOO  is  equivalented  to 
KFF. 

Entity: 

KOOINV 

Entity  TVpe: 

Subscripted  Matrix 

Description: 

Contains  the  upper  and  lower  triangular  matrices  resulting  from  the  symmetric 
decomposition  of  the  KOO  matrix  for  the  current  boundary  condition. 

Matrix  Form: 

A  variable-sized  matrix  having  one  row  and  one  column  for  each  omitted  degree  of 
freedom  in  the  boundary  condition. 

Created  By: 

Notes: 

FREDUCE 

1.  This  matrix  has  the  same  precision  as  the  global  stiffiiess  matrix. 

2.  If  no  degrees  of  freedom  have  been  omitted  in  the  ciuxent  boundary  condi¬ 
tion,  this  matrix  will  have  no  rows  or  colunms. 

3.  This  matrix  is  formed  for  use  by  the  Forward  Backward  Substitution  Utility. 

4.  Note  that  KOOINV  plays  the  same  role  as  KOOL/KOOU  for  symmetric  analy¬ 
ses. 
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Entity: 

KOOL 

Entity  lype: 

Subscripted  Matrix 

Description: 

Contains  the  lower  triangular  portion  of  the  decomposed  partition  of  the  KAAA 
matrix.  Note  that  KAAA  is  asymmetric  requiring  use  of  the  general  decomposition 
routine. 

Matrix  Form: 

Refer  to  the  DECOMP  utility  documentation. 

Created  By: 

FREDUCE 

Notes: 

1.  This  matrix  is  formed  to  be  used  in  the  general  forward  backward  substitu¬ 
tion  module  GFBS. 

2.  Note  that  KOOL/KOOU  play  the  same  role  as  KOOINV  for  asymmetric 
analyses. 

Entity: 

KOOU 

Entity  Type: 

Subscripted  Matrix 

Description: 

Contains  the  upper  triangular  portion  of  the  decomposed  partition  of  the  KAAA 
matrix.  Note  that  KAAA  is  asymmetric  requiring  use  of  the  general  decomposition 
routine. 

Matrix  Form: 

Refer  to  the  DECOMP  utility  documentation. 

Created  By: 

Module  DECOMP 

Notes: 

1.  This  matrix  is  formed  to  be  used  in  the  general  forward  backward  substitu¬ 
tion  module  GFBS. 

2.  Note  that  KOOL/KOOU  play  the  same  role  as  KOOINV  for  asymmetric 
analyses. 

Entity: 

KSOO 

Entity  Type: 

Matrix 

Description: 

Shifted  stiffiiess  matrix  used  in  Generalized  Dynamic  reduction. 

Matrix  Form: 

Real  square  symmetric  matrix  with  one  row  and  one  colunrn  for  each  o-set  of  degree 
of  freedom. 

Created  By: 

Module  GDRl 

Notes: 

1.  This  matrix  is  computed  from:  [KSOO]  =  [KOO]  -sEMOO]; 
with  the  shift  parameter,  s,  computed  in  GDRl. 

Entity: 

KSS 

Entity  Type: 

Matrix 

Description: 

Partition  of  the  KNN  matrix  (see  KGG). 
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Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


KUll 

Subscripted  Matrix 

Upper  triangular  portion  of  the  decomposed  Kll  matrix. 

Square  real  matrix  having  one  row  and  one  column  for  each  a-set  degree  of  freedom. 
DECOMP 


1.  Kll  is  not  symmetric. 

2.  This  matrix  is  formed  for  use  by  the  GFBS  utihty.  , .  n  u 

3.  The  matrix  may  be  required  in  the  sensitivity  analysis  and  is  therefore  su  - 
scripted  by  boundary  condition. 


Kll 

Matrix 

An  intermediate  matrix  that  is  constructed  as  part  of  the  solution  of  unrestramed 
structures. 

A  real,  square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number  of 
a-set  degrees  of  freedom. 

MAPOL 


K1112 

Subscripted  Matrix 

An  intermediate  matrix  required  in  the  static  aeroelastic  trim  analysis. 

A  real  rectangular  matrix  with  the  number  of  rows  equal  to  the  number  of  a-set 
degrees  of  freedom  and  the  number  of  columns  equal  to  the  number  of  r-set  degrees 
of  freedom. 

MAPOL 

1.  The  K1112  matrix  is  computed  as  the  solution  of 

[Kll]  [K1112]  =  [AICS] 

2.  The  matrix  may  be  required  in  the  sensitivity  analysis  and  is  therefore  sub¬ 
scripted  by  boundary  condition. 
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Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 

Entity: 

Entity  TVpe: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


K12 

Subscripted  Matrix 

An  intermediate  matrix  that  is  constructed  as  part  of  the  solution  of  xinrestrained 
structures. 

A  real  rectangular  matrix  with  the  number  of  rows  equal  to  the  number  of  a-set 
degrees  of  freedom  and  the  number  of  columns  equal  to  the  number  of  r-set  degrees 
of  freedom. 

MAPOL 

1.  The  matrix  may  be  required  in  the  sensitivity  analysis  and  is  therefore  sub¬ 
scripted  by  boundary  condition. 


K21 

Subscripted  Matrix 

An  intermediate  matrix  used  in  the  reduction  of  the  aerodynamic  stiffiiess. 

The  number  of  rows  is  equal  to  the  number  of  degrees  of  freedom  in  the  r-set  and 
the  number  of  columns  is  equal  to  the  number  of  rows  in  the  a-set. 

MAPOL 

1.  The  matrix  is  created  from  the  column  merge  of  R32  and  R31. 

2.  Since  this  matrix  is  required  in  the  sensitivity  analysis,  it  is  subscripted  by 
the  boundary  condition  number. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


LAMBDA 

Relation 

Contains  the  results  of  real  eigenvalue  analysis  for  each  modal  analysis  in  each 
boundary  condition. 


NAME 

TYPE/KEY 

DESCRIPTION 

NITER 

Integer 

Iteration  number 

BCID 

Integer 

The  boundary  condition  number 

MODENO 

Integer 

The  mode  number  of  the 
eigenvalue/eigenvector 

EXORD 

Integer 

The  extraction  order  for  the  mode  | 

EIGVAL 

Real 

The  eigenvalue 

RFREQ 

Real 

The  modal  frequency  in  rad/s 

CFREQ 

Real 

The  modal  frequency  in  Hertz 

VECFLG 

Integer 

=  1  if  a  vector  was  generated  for  the  mode 
=  0  if  only  the  value  was  extracted 

GMASS 

Real 

The  generalized  mass  associated  with  the 
mode 

GSTIFF 

Real 

The  generalized  stiffiiess  associated  with 
the  mode 

Module  REIG 

1,  The  relation  contains  one  tuple  for  each  mode  extracted  in  each  eigenanalysis. 

2.  All  eigenvalues  for  all  boundary  conditions  at  each  design  iteration  are  stored 
for  retrieval  in  sensitivity  evaluation. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


LANDAC 

Relation 

Contains  the  resvdts  of  complex  eigenvalue  analysis  for  each  modal  analysis  in  each 
boxmdary  condition. 


NAME 

TYPE/KEY 

DESCRIPTION 

BCID 

Integer 

The  boundary  condition  number 

MODENO 

Integer 

The  mode  nximber  of  the 
eigenvalue/eigenvector 

EXORD 

Integer 

The  extraction  order  for  the  mode 

REIGVAL 

Real 

The  real  part  of  the  eigenvalue 

lEIGVAL 

Real 

The  imaginary  part  of  the  eigenvalue 

NFREQ 

Real 

The  natural  frequency  in  Hertz 

DFREQ 

Real 

The  damped  frequency  in  Hertz 

DPCOEF 

Real 

The  damping  coefficient 

Module  CEIG 


1.  The  relation  contains  one  tuple  for  each  mode  extracted  in  each  eigenanalysis. 

LDVLIST 

Relation 

Contains  the  definition  of  the  list  of  local  design  iterations  as  input  from  the  Bulk 
Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer 

Set  identification  number 

ETYPE 

Tbxt(8) 

Element  type 

LAYRNUM 

Integer 

Layer  number  for  composites  or  zero 

DVSYMBL 

T)ext(8) 

Designed  dimension  symbol 
(Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9,  DIO 
for  BAR  element  cross  section 

dimension;  A  for  element  area,  T  for 
element  thickness;  M  for  element  mass;  K 
for  element  stiffiiess.) 

EID 

Integer 

Element  identification  number 

Module  IFF 
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Entity: 

Entity  IVpe: 
Description: 

Matrix  Form: 

Created  By: 

Notes: 

Entity: 

Entity  TVpe: 
Description: 

Matrix  Form: 

Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


LHS 

Subscripted  Matrix 

This  is  essentially  a  matrix  of  rigid  body  mass  values  with  the  exact  definition 
depending  on  the  type  of  free-free  analysis  being  performed. 

The  dimension  of  the  square  matrix  is  equal  to  the  number  of  degrees  of  freedom  in 
the  r-set. 

MAPOL 

1.  For  an  inertia  relief  analysis,  LHS  is  equal  to  MRR. 

2.  For  a  static  aeroelastic  analysis,  LHS  is  equal  to  MRR  plus  K21  times  K1112. 

LKQ 

Matrix 

Lower  triangular  portion  of  the  decomposed  KEQE  matrix. 

Square  real  matrix  having  one  row  and  one  column  for  each  elastic  mode  retained 
in  the  nuclear  blast  response  analysis. 

DECOMP 

1.  KEQE  is  not  symmetric. 

2.  This  matrix  is  formed  for  use  by  the  GFBS  utility. 

LOAD 

Relation 

Contains  the  definition  of  a  static  load  that  is  a  linear  combination  of  loads  defined 
by  FORCE,  MOMENT,  FORCEl,  MOMENTl,  PLOAD,  and  GRAV  entries. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

SCALE 

Real 

Scale  factor  for  combination 

SCALEI 

Real 

Scale  factor  for  component  load 

LOADI 

Integer  >  0 

Set  identification  number  of  the  component 
load 

Module  IFP 

1.  The  relation  contains  one  tuple  for  each  load  set  id  specified  in  each  umque 
SETID. 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


LOCLVAR 

Relation 

Contains  the  relationship  between  local  variables  and  global  variables  in  the  design 
problem.  Acts  as  a  pointer  to  the  PTRANS  matrix. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification 

ETYPEl 

Ifext  (8) 

Element  t37pe 

PID 

Integer  >  0 

Element  property  identification 

PTYPE 

Text  (8) 

Element  property  type 

LAYRNUM 

Integer  >  0 

Layer  number  for  composites 

DVSYMBL 

Text(8) 

Designed  dimension  s3rmbol 
(Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9,  DIO  for 
BAR  element  cross  section  dimension;  A  for 
element  area,  T  for  element  thickness;  M  for 
element  mass;  K  for  element  stiffiiess.) 

PROW 

Integer  >  0 

Pointer  to  (P)  row  for  this  element 

PTYP 

Integer  =  1,  2  or  3 

Flag  indicating  type  of  associated  global 
variable 

TMIN 

Real 

Minimum  value  for  physical  property 

TMAX 

Real 

Maximum  value  for  physical  property 

Module  MAKEST 


1.  This  entity  is  used  to  create  move  limits  on  the  physical  design  variables  in 
the  TCEVAL  module. 

2.  The  PTYP  attribute  indicates  the  linking  option  for  the  physical  variable 
=  1  unique  physical  linking  (DESELM) 

=  2  physical  linking  (DESVARP) 

=  3  shape  function  linking  (DESVARS) 
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Entity: 
Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


LSOO 

Matrix 

Lower  triangular  portion  of  the  decomposed  KSOO  matrix. 

Square  real  matrix  having  one  row  and  column  for  each  o-set  degree  of  freedom  in 
Generahzed  Dynamic  Reduction. 

DECOMP 

1.  This  matrix  is  formed  for  use  by  the  FBS  large  matrix  utility. 

2.  LSOO  is  computed  only  when  there  are  k-set  degrees  of  freedom  in  a  general¬ 
ized  dynamic  reduction  analysis. 

MAA 

Matrix 

Mass  matrix  in  the  a-set  derived  from  partitions  of  the  MFF  matrix  (see  MGG). 


MAABAR 

Matrix 

A  partition  of  the  MFF  matrix  (see  MGG). 

MACHLXST 

Relation 

Contains  the  list  of  Mach  numbers  as  input  from  the  Bulk  Data  file. 


1  NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer 

Set  identification  number 

1  MACH 

Real  >  0.0 

Mach  number 

Module  IFP. 
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MASDRVA 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


Relation 

Contains  the  user  function  requested  element  mass  sensitivity  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

MXCOL 

Integer  >  0 

Matrix  column  number  in  [MXMASDVA]  for 
the  sensitivity  values 

Module  MSWGGRAD 

lyiASRKSP 

Relation 

Contains  the  user  function  requested  element  mass  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value 

Module  MSWGRESP 
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Entity: 

Entity  lype: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 


MASSEST 

Relation 

Contains  the  element  summary  data  for  the  MASSl  and  MASS2  elements. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

SILl 

Integer  >  0 

Internal  grid  or  scalar  point  id 

SIL2 

Integer  >  0 

Internal  grid  or  scalar  point  id 

COMPNTl 

Integer  >  0 

Component  of  SILl  to  which  the  element  is 
attached 

COMPNT2 

! 

Integer^  0 

Component  of  SIL2  to  which  the  element  is 
attached 

MASS 

Real 

Mass  value 

DESIGN 

Integer  >  0 

Design  flag 

Module  MAKEST 


1.  A  nonzero  design  flag  denotes  that  the  element  is  affected  by  a  design  vari¬ 
able. 

2.  This  relation  is  built  from  the  CMASSl  and  CMASS2  relations  along  with  as¬ 
sociated  property,  design  and  grid  relations.  It  contains  one  tuple  for  each 
scalar  mass  element  in  the  problem. 

MATSS 

Matrix 

Matrix  of  steady-state  influence  coefficients  used  in  the  nuclear  blast  response 

analysis. 

Real  square  matrix  with  one  row  and  column  for  each  panel  in  the  unsteady 

aerodynamics  model. 

Module  BLASTFIT 


Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


MATTR 

Matrix 

Matrix  of  transient  influence  coefficients  used  in  the  nuclear  blast  response  analysis. 

Real  rectangular  matrix  with  one  row  for  each  panel  in  the  unsteady  aerodynamics 
model  and  a  column  dimension  equal  to  the  number  of  panels  times  the  number  of 
beta  values  used  in  fitting  procedure  of  the  transient  blast  response  calculations. 

Module  BLASTFIT 

MATl 

Relation 

Contains  the  material  properties  for  linear  isotropic  materials  as  input  from  the 
Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

I  MID 

Integer  >  0,  key 

Material  property  identification 

E 

Real 

Young’s  Modulus 

G 

Real 

Shear  Modulus 

NU 

Real 

Poisson’s  Ratio  1 

RHO 

Real 

Density 

ALPHA 

Real 

Thermal  expansion  coefficient 

TREE 

Real 

Thermal  expansion  reference  temperatxire  I 

DAMPING 

Real 

Structural  damping  coefficient 

ST 

Real 

Tension  stress  allowable 

SC 

Real 

Compression  stress  allowable 

1  ss 

Real 

Shear  stress  allowable 

1  MSCID 

Integer  >  0 

Material  coordinate  system  id 

Created  By: 


Module  IFF 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


MAT2 

Relation 

Contains  the  material  properties  for  linear  anisotropic  materials  for  two-dimen¬ 
sional  elements  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

MID 

Integer  >  0,  key 

Material  identification  number 

Gll,  G12,  G13 

Real 

Components  of  the  6x6  symettric 
material  properties  matrix 

G22,  G23,  G33 

Real 

RHO 

Real 

Density 

ALPHl 

Real 

Thermal  expansion  coefficient  vector 

ALPH2 

Real 

ALPHl 2 

Real 

TREF 

Real 

Thermal  expansion  reference 
temperature 

DAMPING 

Real 

Structural  damping  coefficient  1 

ST 

Real 

Tension  stress  allowable  1 

SC 

Real 

Compression  stress  allowable 

SS 

Real 

Shear  stress  allowable 

j  MSCID 

Integer  >  0 

Material  coordinate  system  id 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


MATS 

Relation 

Contains  the  material  properties  for  orthotropic  materials  for  two-dimensional 
elements  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

MID 

Integer  >  0,  key 

Material  identification  nmnber 

El 

Real  ^  0.0 

Logitudinal  modulus  of  elasticity 

E2 

Real  ^  0.0 

Transverse  modulus  of  elasticity 

NU12 

Real 

Poisson’s  ratio 

G12 

Real  >  0.0 

In-plane  shear  modulus 

GIZ 

Real  >  0.0 

Transverse  shear  modulus  in  1-z  plane 

G2Z 

Real  >  0.0 

Transverse  shear  modulus  in  2-z  plane 

RHO 

Real  >  0.0 

Mass  density 

ALPHl 

Real 

Thermal  expansion  coefiBcient  in  1-direction 

ALPH2 

Real 

Thermal  expansion  coefficient  in  2-direction 

TREE 

Real 

Element  reference  temperature 

XT 

Real  ^  0.0 

Allowable  longitudinal  tension  stress 

XC 

Real 

Allowable  longitudinal  compression  stress 

YT 

Real  >  0.0 

Allowable  transverse  tension  stress 

YC 

Real 

Allowable  transverse  compression  stress 

SS 

Real  >  0.0 

Allowable  in-plane  shear  stress 

DAMPING 

Real 

Structural  damping  value 

F12 

Real 

Tsai  Wu  tensor  pol3mominal  theory 
interaction  term 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


MAT9 

Relation 

Contains  the  material  properties  for  orthotropic  materials  for  three-dimensional 
elements  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

MID 

Integer  >  0,  key 

Material  identification  number 

Gll 

Real 

Tfensile  modulus  in  the  1-direction 

G12 

Real 

Shear  modulus  in  the  1-2  plane 

G13 

Real 

Shear  modulus  in  the  1-3  plane 

G14 

Real 

Shear  modulus  in  the  1-4  plane 

G15 

Real 

Shear  modulus  in  the  1-5  plane 

G16 

Real 

Shear  modulus  in  the  1-6  plane 

G22 

Real 

Tensile  modulus  in  the  2-direction 

G23 

Real 

Shear  modulus  in  the  2-3  plane 

G24 

Real 

Shear  modulus  in  the  2-4  plane  | 

G25 

Real 

Shear  modulus  in  the  2-5  plane 

G2  6 

Real 

Shear  modulus  in  the  2-6  plane 

G33 

Real 

Tensile  modulus  in  the  3-direction 

G3  4 

Real 

Shear  modulus  in  the  3-4  plane  1 

G35 

Real 

Shear  modulus  in  the  3-5  plane 

G36 

Real 

Shear  modulus  in  the  3-6  plane 

G44 

Real 

Tensile  modulus  in  the  4-direction 

G45 

Real 

Shear  modulus  in  the  4-5  plane 

G46 

Real 

Shear  modulus  in  the  4-6  plane 

G55 

Real 

Tfensile  modulus  in  the  5-direction 

G56 

Real 

Shear  modulus  in  the  5-6  plane 

G66 

Real 

Tensile  modulus  in  the  6-direction  j 

RHO 

Real 

Mass  Density 

ALPHl 

Real 

Thermal  expansion  coefScient  in  1-direction  1 

ALPH2 

Real 

Thermal  expansion  coefficient  in  2-direction  | 

ALPH3 

Real 

Thermal  expansion  coefficient  in  3-direction  j 

ALPH4 

Real 

Thermal  expansion  coefficient  in  4-direction  | 

ALPH5 

Real 

Thermal  expansion  coefficient  in  5-direction  j 
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NAME 

TYPE/KEY 

DESCRIPTION 

ALPH6 

Real 

Thermal  expansion  coefficient  in  6-direction 

TREF 

Real 

Element  reference  temperature 

GE 

Real 

Structural  damping  coefficient  | 

Created  By: 

Module  IFF 

Entity: 

MDD 

Entity  Type: 

Matrix 

Description: 

Mass  matrix  in  the  direct  set. 

Matrix  Form: 

Square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number  of  degrees 
of  freedom  in  the  d-set. 

Created  By: 

DMA 
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Entity; 

Entity  Type: 
Description; 

Entity  Structure: 
Record: 


Created  By: 
Notes; 


MELM 

Unstructured 

An  unstructured  database  entity  that  contains  the  matrix  partitions  of  nondesigned 
mass  and  linearly  designed  mass. 


i.  If  the  element  is  a  scalar  element: 

the  record  contains  the  components  of  the  connected  grid  point(s)  (if 
any)  and  the  value  M. 


1  MCODE 

FORMAT  OF  RECORD 

1 

M 

2 

COMPl,  0,  +-M,-+M 

3 

0,COMP1,  +-M,-+M 

4 

+-M,— i-M 

5 

COMPl,  0,  M 

6 

COMPl,  COMP2,  -i-M,-+M  | 

Else 

the  record  contains  a  partition  of  the  stififiaess  matrix  with  either  one, 
three,  or  six  entries  for  each  node 


KCODE 

FORMAT  OF  RECORD  | 

7 

3  columns  of  3  entries/node 

10 

3  columns  of  1  entry/node  (diagonal)  1 

Module  EMG 

1.  This  entity  contains  one  record  for  each  strip  of  each  element  mass  matrix.  A 
strip  or  partition  is  defined  as  all  those  columns  of  the  element  matrix  associ¬ 
ated  with  a  pivot  sil  (the  id  of  the  first  dof  of  a  grid  point  or  the  id  of  a  scalar 
point). 

2.  Refer  to  the  DVCT  relation  for  fiuther  details,  as  these  two  database  entities 
are  closely  linked. 

3.  The  matrix  partitions  are  stored  in  the  same  precision  as  the  MGG  matrix. 

4.  The  records  related  to  nonlinear  design  mass  are  empty. 

5.  MELM  and  DMELM  are  used  to  generate  all  of  the  element  mass  sensitivity 
matrix  partitions. 

6.  MELM  and  MELMD  are  used  to  generate  all  of  the  element  mass  sensitivity 
matrix  partitions. 
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MELMD 


Entity: 

Entity  Type: 
Description: 

Entity  Structure: 
Record: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Notes: 


Unstructured 

An  unstructured  database  entity  that  contains  the  element  nonlinear  design  mass 
matrix  partitions. 


the  record  contains  a  partition  of  the  stifbiess  matrix  with  either  one,  three, 
or  six  entries  for  each  node 


KCODE 

FORMAT  OF  RECORD 

7 

3  columns  of  3  entries/node 

10 

3  columns  of  1  entry/node  (diagonal) 

Module  EMG 

1.  This  entity  contains  one  record  for  each  strip  of  each  element  nonlinear  de¬ 
sign  mass  matrix.  A  strip  or  partition  is  defined  as  all  those  columns  of  the 
element  matrix  associated  with  a  pivot  sil  (the  id  of  the  first  dof  of  a  grid 
point  or  the  id  of  a  scalar  point). 

2.  Refer  to  the  DVCTD  relation  for  further  details,  as  these  two  database  enti¬ 
ties  are  closely  linked. 

3.  The  matrix  partitions  are  stored  in  the  same  precision  as  the  MGG  matrix. 

4.  MELMD  and  MELM  are  used  to  generate  all  of  the  element  mass  sensitivity 
matrix  partitions. 

MFF 

Matrix 

A  partition  of  the  MNN  matrix  (see  MGG). 

MFORM 

Relation 

Contains  the  mass  matrix  form  as  specified  in  the  Bulk  Data  file. 


NAMES 

TYPE/KEY 

DESCRIPTION 

VALUE 

IfextCS) 

The  mass  matrix  form;  either  LUMPED  or 
COUPLED.  1 

1.  If  this  relation  is  empty,  the  LUMPED  form  will  be  used.  If  more  than  one  tu¬ 
ple  is  defined,  any  tuple  containing  the  "COUPLED"  option  will  cause  the  cou¬ 
pled  mass  form  to  be  used. 
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Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 
Entity  Type: 
Description: 
Matrix  Form 

Created  By: 
Notes: 


MGG 

Matrix 

Contains  the  cxirrent  global  mass  matrix  for  the  design  problem. 

A  variable-size  symmetric  (possibly  diagonal)  matrix  having  one  row  and  one  column 
for  each  structural  degree  of  freedom  in  the  problem. 

Module  MAPOL 


1. 

2. 


The  MGG  matrix  is  formed  in  the  second  phase  m^s  mato  ass^bly. 

The  MAPOL  sequence  supports  the  following  partitions  of  the  MGG  matrix 
rcoo  TVipnrPtical  Manual  for  the  explicit  formation  of  these  matrices): 


MGG  -4 


<P 

MMN 


MNN 


<P  9 
(p  MFF 


MFF 


MOO 

9 


MOA 

MAABAR 


MAA 


MRRBAR  9 
MLR  MLL 


MHH 

Subscripted  Matrix 

Contains  the  modal  mass  output  from  the  dynamic  matrix  assembly. 

A  variable-sized  matrix  having  one  row  and  one  column  for  each  eigenvector 
computed  in  the  real  eigenanalysis. 

Module  DMA 

1.  This  matrix  is  needed  for  flutter  constraint  sensitivities  so  it  is  subscripted 
for  each  boundary  condition. 

2.  INFO(ll)  contains  a  flag  denoting  whether  the  matrix  is  coupled  or  uncoupled 

=  0  Uncoupled 

=  1  Coupled 


Mil 

Matrix 

Generalized  mass  matrix  computed  by  the  eigenanalysis  module. 

Square  diagonal  matrix  with  the  number  of  rows  and  columns  equal  to  the  number 
of  modes  retained  by  the  eigenanalysis. 

Module  REIG 

1.  Currently  this  matrix  is  computed  and  not  used;  it  is  available  for  printout. 


Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 


MKAEROl 

Relation 

Contains  a  table  of  Mach  numbers  and  reduced  frequencies  for  unsteady  aerody¬ 
namic  matrix  calculation  as  input  from  the  bulk  data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

I  SYMXZ 

Integer 

Symmetry  flag  for  xz-plane 

1  SYMXY 

Integer 

S3Tiimetry  flag  for  xy-plane 

MACHl 

Real 

Mach  number 

MACH2 

Real 

MA.CH3 

Real 

MACH4 

Real 

MACHS 

Real 

MACH6 

Real 

RFREQl 

Real 

Reduced  frequencies 

RFREQ2 

Real 

RFREQ3 

Real 

RFREQ4 

Real 

RFREQ5 

Real 

RFREQ6 

Real 

RFREQ7 

Real 

RFREQ8 

Real 

1 

Module  IFF 
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Entity  Type: 
Description: 


Relation  Attributes: 


Created  By: 

Entity: 
Entity  Type: 
Description: 


MKAER02 

Relation 

Contains  mach  number  and  reduced  frequency  pairs  to  be  used  in  unsteady  aerody¬ 
namic  matrix  generation. 


Module  IFF 

MLL 

Matrix 

A  partition  of  the  MAA  matrix  (see  MGG). 


Entity: 


Entity  Type: 
Description: 


MLR 

Matrix 

A  partition  of  the  MAA  matrix  (see  MGG). 


Entity:  MNN 

Entity  Type-  Matrix 

Description:  The  mass  matrix  in  the  n-set  derived  from  partition  of  the  MGG  matrix  (see  MGG). 


Entity: 
Entity  Type: 
Description: 


MOA 

Matrix 

A  partition  of  the  MFF  matrix  (see  MGG). 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 

Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


MODELIST 

Relation 

Contains  the  list  of  normal  modes  for  which  outputs  are  requested  as  input  from 
the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer 

Set  identification  number 

MODE 

Integer 

Mode  number 

Module  IFF 


MOMENT 

Relation 

Contains  the  definition  of  a  static  moment  at  a  grid  point  as  input  from  the  Bulk 
Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  niimber 

GRIDl 

Integer  >  0 

Grid  point  at  which  the  moment  is  apphed 

CIDl 

Integer  >  0 

Coordinate  system  identification 

SCALE 

Real 

Scale  factor 

Nl,  N2,  N3 

Real 

Components  of  the  vector 

Created  By: 


Module  IFF 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 


MOMENTl 

Relation 

Contains  the  definition  of  a  moment  applied  at  a  grid  point  with  the  direction 
determined  by  a  line  connecting  two  grid  points. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

GRIDl 

Integer  >  0 

Grid  point  id  at  which  the  moment  is  applied 

SCALE 

Real 

Scale  factor 

GRID2 

Integer  >  0 

Grid  point  identification  1 

GRIDS 

Integer  >  0 

Grid  point  identification  | 

Module  IFF 


MOO 

Matrix 

A  partition  of  the  MFF  matrix  (see  MGG). 


MPART 

Matrix 


A  partitioning  vector  used  to  separate  rigid  body  and  elastic  modes  for  nuclear  blast 
response. 

A  real  vector  with  the  number  of  rows  equal  to  the  number  of  modes  retained  for 
the  nuclear  blast  response.  Rigid  modes  are  denoted  by  0.0  while  elastic  modes  are 
denoted  by  1.0. 

Module  BLASTFIT 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


MFC 

Relation 

Contains  the  multipoint  constraint  data  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

DEPEND 

Integer  >  0 

Dependent  grid  or  scalar  point  id 

COMPNTl 

Integer  >  0 

Component  of  DEPEND  that  is  constrained 

DEPCOEF 

Real 

Coefficient  of  constraint  for  the  dependent  dof 

GRID2 

Integer  >  0 

Grid  or  scalar  point  id 

COMPNT2 

Integer  >  0 

Component  of  GRID2  that  specifies  a  constraint 

MPCCOEF 

Real 

CoeflScient  of  constraint 

Module  IFF 

1.  The  relation  contains  one  tuple  for  each  component  constrained  in  each 
unique  SETID. 

MPCADD 

Relation 

Contains  the  definition  of  a  multipoint  constraint  set  that  is  a  union  of  sets  contained 
in  the  MFC  relation. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

SETID 

Integer  >  0 

Set  identification  number 

MPCSETID 

Integer  >  0 

The  SETID  of  the  MFC  relation  tuples  to  be 
used 

Module  IFF 
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Entity: 
Entity  Type: 
Description: 


Created  By: 
Notes: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 


MPPARM 

Realtion 

Contains  the  optimizer  parameters  and  their  new  values  for  use  in  the  ASTROS 
mathematical  programming  optimizer  as  input  from  the  Bulk  Data  File. 


NAME 

TYPE/KEY 

DESCRIPTION 

PARAM 

Ttext  (8) 

Name  of  the  parameter 

INTPARM 

Integer 

Value  of  integer  parameters 

RSPPARM 

Real 

Value  of  real  parameters 

Module  IFF 

1.  This  relation  is  used  in  module  DESIGN  to  provide  for  user  specification  of 
optimizer  parameters. 


MRR 

Subscripted  Matrix 

To  reduce  mass  matrix  for  the  structural  model. 

A  variable-sized  matrix  having  one  row  and  one  column  for  each  degree  of  freedom 
in  the  support  set  for  the  current  boundary  condition. 

MAPOL 

1.  This  matrix  is  required  to  compute  strength  constraint  sensitivities  for  unre¬ 
strained  structures  and  trim  parameter  sensitivities  for  steady  aerolastic  opti¬ 
mization  so  it  is  subscripted  for  each  boimdary  condition. 


MRRBAR 

Matrix 

A  partition  of  the  MAA  matrix  (see  MGG). 

MXDSPDVA 

Matrix 

Matrix  contains  displacement  response  sensitivity  to  the  design  variables. 

A  variable-sized  matrix  having  one  row  for  each  design  variable  and  one  column  for 
each  requested  displacement  response. 

MKAMAT 
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Entity: 

MXELMDVA 

Entity  lype: 

Matrix 

Description: 

Matrix  contains  element  stress  and  strain  response  sensitivity  to  the  design  vari¬ 
ables. 

Matrix  Form: 

A  variable-sized  matrix  having  one  row  for  each  design  variable  and  one  column  for 
each  requested  element  stress/strain  response. 

Created  By: 

MKAMAT 

Entity: 

MXFCFDVA 

Entity  Type  : 

Matrix 

Description: 

Matrix  contains  steady  aeroelastic  flexible  stability  coefficient  response  sensitivity 
to  the  design  variables. 

Matrix  Form: 

A  variable-sized  matrix  having  one  row  for  each  design  variable  and  one  column  for 
each  requested  flexible  stability  coefficient  response. 

Created  By: 

AEROEFFS 

Entity: 

MXFDPDVA 

Entity  T^pe: 

Matrix 

Description: 

Matrix  contains  flutter  damping  response  sensitivity  to  the  design  variables. 

Matrix  Form: 

A  variable-sized  matrix  having  one  row  for  each  design  variable  and  one  colinnn  for 
each  requested  flutter  damping  response. 

Created  By: 

FLUTSENS 

Entity: 

MXFFQDVA 

Entity  Type: 

Matrix 

Description: 

Matrix  contains  flutter  freqency  response  sensitivity  to  the  design  variables. 

Matrix  Form: 

A  variable-sized  matrix  having  one  row  for  each  design  variable  and  one  column  for 
each  requested  flutter  frequency  response. 

Created  By: 

FLUTSENS 

Entity: 

MXFRQDVA 

Entity  Type: 

Matrix 

Description: 

Matrix  contains  normal  mode  response  sensitivity  to  the  design  variables. 

Matrix  Form: 

A  variable-sized  matrix  having  one  row  for  each  design  variable  and  one  column  for 
each  requested  normal  mode  response. 

Created  By: 

FREQSENS 
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Entity; 

MXFRTDVA 

Entity  Type: 

Matrix 

Description: 

Matrix  contains  flutter  root  response  sensitivity  to  the  design  variables. 

Matrix  Form; 

A  variable-sized  matrix  having  one  row  for  each  design  variable  and  two  columns 
for  each  requested  flutter  root  response  (the  first  column  for  the  real  part  and  the 
second  column  for  the  imaginary  part). 

Created  By; 

MKAMAT 

Entity: 

MXGDVDVA 

Entity  Type: 

Matrix 

Description: 

Matrix  contains  global  design  variable  sensitivity  to  the  design  variables. 

Matrix  Form; 

A  variable-sized  matrix  having  one  row  for  oach  design  variable  and  ono  column  for 
each  requested  global  design  variable  intrinsic. 

Created  By: 

GDVGRAD 

Entity: 

MXMASDVA 

Entity  Type: 

Matrix 

Description: 

Matrix  contains  element  mass  intrinsic  sensitivity  to  the  design  variables. 

Matrix  Form: 

A  variable-sized  matrix  having  one  row  for  each  design  variable  and  one  column  for 
each  requested  element  mass  intrinsic. 

Created  By: 

MSWGGRAD 

Entity: 

MXTHKDVA 

Entity  Type: 

Matrix 

Description: 

Matrix  contains  element  thickness  intrinsic  sensitivity  to  the  design  variables. 

Matrix  Form: 

A  variable-sized  matrix  having  one  row  for  each  design  variable  and  one  column  for 
each  requested  element  thickness  intrinsic. 

Created  By; 

MAKDFV 

Entity: 

MXTRMDVA 

Entity  Type: 

Matrix 

Description; 

Matrix  contains  steady  aeroelastic  trim  parameter  response  sensitivity  to  the  design 
variables. 

Matrix  Form; 

A  variable-sized  matrix  having  one  row  for  each  design  variable  and  one  column  for 
each  requested  trim  parameter  response. 

Created  By: 

AEROSENS 
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Entity: 

MXWGHDVA 

Entity  Type: 

Matrix 

Description: 

Matrix  contains  element  weight  intrinsic  sensitivity  to  the  design  variables. 

Matrix  Form: 

A  variable-sized  matrix  having  one  row  for  each  design  variable  and  one  column  for 
each  requested  element  weight  intrinsic. 

Created  By: 

MSWGGRAD 

Entity: 

NLGLBSIG 

Entity  IVpe: 

Matrix 

Description: 

Contains  the  stress  and  strain  components  in  the  element  coordinate  system  for 
elements  nonlinearly  constrained  through  stress/strain  constraint  bulk  data  en¬ 
tries. 

Matrix  Form: 

A  variable-size  matrix  having  one  row  for  each  stress/strain  component  for  each 
element  subject  to  a  nonlinear  strength  constraint  and  one  column  for  each  load 
condition  within  each  boundary  condition.  The  order  of  the  matrix  rows  is  in 
element  id  order  of  linearly  constrained  elements  within  each  element  type.  The 
element  t3rpes  are  currently  processed  in  the  following  order: 

(1)  BAE;  ''al,  ^a2,  ^2i4,  %1,  %2,  %S,  %4 

(2)  QUAD4;  ®x,  ‘"y,  V 

(3)  TRIAS;  ‘^x,  ®y,  V 

The  columns  are  processed  in  load  condition  order  for  each  boundary  condition. 

Created  By: 

Module  SCEVAL 

Notes: 

1.  If  no  elements  are  nonlinearly  constrained,  this  matrix  will  be  empty. 

2.  Refer  to  the  NLSMAT  documentation  for  fhrther  details  as  NLGLBSIG  is  es¬ 
sentially: 

[NLSMAT]*^  [Ug] 

3.  Each  boundary  condition’s  load  conditions  are  appended  onto  the  existing 
NLGLBSIG  columns  within  the  SCEVAL  module. 


Entity: 

Entity  Type: 
Description: 

Matrix  Form: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


NLSMAT 

Matrix 

Contains  the  nonlinear  portion  of  sensitivity  of  the  stress  and  strain  in  the  elements 
coordinate  system  to  the  global  displacements. 

A  variable-sized  matrix  having  one  column  for  every  stress/strain  term  in  each 
element  that  is  nonlinearly  constrained  by  a  stress/strain  constraint  tuple  or  its 
stress/strain  responses  are  required  by  user  functions,  and  one  row  for  every 
degree  of  freedom.  The  columns  are  stored  in  the  order  the  nonlinearly 
constrained  elements  are  processed  in  EMG.  Relation  NLSMTCOL  has  the  matrix 
[NLSMAT]  colmnn  information  for  each  related  element. 

Module  NLEMG 

1.  This  matrix  is  not  built  if  all  elements’  stress  or  strain  constraints  are  linear 
in  the  design  variables. 

2.  NLSMAT  and  SMAT  are  used  by  SCEVAL  module  for  constraint  evaluation 
and  MAKDFU  for  sensitivity  evaluation. 


NLSMTCOL 

Relation 

Contains  the  matrix  [NLSMAT]  column  information  for  the  realted  elements. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

Text  (8) 

Element  type 

LAYERNUM 

Integer  >  0 

Composite  layer  number 

STRECOL 

Integer  >  0 

The  first  column  number  in  [NLSMAT]  for  this 
element/layer  stress 

NCOLSTRE 

Integer  >  0 

The  number  of  columns  in  [NLSMAT]  for  this 
element/layer  stress 

STRACOL 

Integer  >  0 

The  first  column  number  in  [NLSMAT]  for  this 
element/layer  strain 

NCOLSTRA 

Integer  >  0 

The  number  of  columns  in  [NLSMAT]  for  this 
element/layer  strain  1 

Module  NLEMG 
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Entity: 

Entity  T^pe: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


OAGRDDSP 

Relation 

Contains  the  displacements  on  the  aerodynamic  boxes  (“grids”)  for  static  aeroelas- 
ticity,  flutter,  transient/gust  and  blast  disciplines  that  are  requested  for  print  or 
punch  in  Solution  Control. 


NAME 

TYPE/KEY 

DESCRIPTION 

NITER 

Integer 

Iteration  number 

BCID 

Integer 

The  boundary  condition  number 

DISC 

Integer 

Discipline  t)^)®  from  CASE 

SUBCASE 

Integer 

Subcase  identification  number  from  CASE 
relation 

MODENO 

Integer 

Normal  mode  number  for  FLUTTER 

CMPLX 

Integer 

Real  or  complex  flag 
=  1  if  real  displacement 
=  2  if  complex  displacement 

EXTID 

Integer 

External  identification  number  of  the 
aerodynamic  box  (See  Remark  1) 

INTID 

Integer 

Internal  identification  number  of  the 
aerodynamic  box 

RDISP 

Real 

Real  part  of  the  normal  displacement 

IDISP 

Real 

Imaginary  part  of  the  normeil  displacement 

Many  Modules 


1.  The  “grids”  referred  to  by  the  EXTID  are  actually  the  aerod3mamic  box  ele¬ 
ments.  Each  of  these  elements  is  physically  located  at  the  centroid  of  a  quad¬ 
rilateral  or  triangular  plate  (the  location  of  which  is  stored  in  GEOMSA  or 
GEOMUA  depending  on  the  model). 

2.  The  DISC  flag  also  indicates  which  model  is  referred  to  by  the  results: 
SAERO  refers  to  the  planar  static  aero  model 

FLUTTER,  TRANSIENT,  FREQUENCY  and  BLAST  refer  to  the  unsteady 
aero  model 


688 


Entity; 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


OAGRDLOD 

Relation 

Contains  the  trimmed  applied  steady  aerodynamic  forces  and  pressures  on  the 
planar  and  nonplanar  static  aerodynamic  boxes  (“grids”)  that  are  requested  for  prmt 
or  punch  in  Solution  Control. 


NAME 

TYPE/KEY 

DESCRIPTION 

NITER 

Integer 

Iteration  number 

BCID 

Integer 

The  boundary  condition  number 

DISC 

Integer 

Discipline  type  flag  from  CASE 

SUBCASE 

Integer 

Subcase  identification  number  (Normal 
mode  number  for  FLUTTER) 

LOADTYPE 

Text(8) 

Label  identifying  the  type  of  the  load  (See 
Remark  1) 

EXTID 

Integer 

External  identification  number  of  the 
aerod3niamic  box  (See  Remark  2) 

INTID 

Integer 

Internal  identification  number  of  the 
aerodynamic  box 

AREA 

Real 

Area  of  the  box 

FORCE 

Real 

Real  part  of  the  applied  normal  force 

PRESS 

Real 

Real  part  of  the  applied  pressure 

Many  Modules 

1.  The  LOADTYPE  is  a  textual  key  that  identifies  the  load  terms. 

The  following  values  are  used: 

APPLIED  -  User  defined  applied  load  from  all  disciplines  except 

NPSAERO.  For  NPSAERO,  the  APPLIED  load  is  equivalent 
to  the  RIGID  load.  The  RIGID  load  is  not  stored. 

RIGID  -  Trimmed  rigid  aerodynamic  load  from  SAERO 
FLEXIBLE  -  Trimmed  flexible  contribution  to  aerodynamic  load  from 
SAERO 

2.  The  “grids”  referred  to  by  the  EXTID  are  actually  the  aerodynamic  box  ele¬ 
ments.  Each  of  these  elements  is  physically  located  at  the  centroid  of  a  quad¬ 
rilateral  or  triangular  plate  (the  location  of  which  is  stored  in  GEOMSA  or 
GEOMUA  depending  on  the  model). 

3.  The  DISC  flag  also  indicates  which  model  is  referred  to  by  the  restilts: 
NPSAERO  refers  to  the  nonplanar  static  aero  model 

SAERO  refers  to  the  planar  static  aero  model 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 
Entity  I^pe: 
Description: 


Created  By: 
Notes: 


OCEIGS 

Relation 

Contains  statistical  information  of  complex  eigenvalue  analysis. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

METHOD 

'Ifext(8) 

Method  of  complex  eigenvalue  extraction 

BCID 

Integer 

Boundary  condition  number 

NLAMA 

Integer 

Number  of  eigenvalue 

NVECTOR 

Integer 

number  of  eigenvectors 

NOSTRT 

Integer 

Number  of  passes  through  the  starting 
points 

NOMOVS 

Integer 

Number  of  starting  point  moves 

NODCMP 

! 

Integer 

Number  of  decomposition 

ITER 

Integer 

1  Totdl  number  of  iterations 

ITERM 

Integer 

Reason  for  termination 

Module  CEIG 

OCPARM 

Realtion 

Contains  the  optimizer  parameters  and  their  new  values  for  use  in  the  ASTROS 
optimality  criterion  methods  as  input  from  the  Bulk  Data  File. 


NAME 

TYPE/KEY 

DESCRIPTION 

PARAM 

Ttext  (8) 

Name  of  the  parameter 

INTPARM 

Integer 

Value  of  integer  parameters  j 

RSPPARM 

Real 

Value  of  real  parameters  | 

Module  IFP 


1.  Used  by  the  VANGO  module  to  override  default  values  of  control  parameters. 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


OEIGS 

Relation 

Contains  statistical  information  of  real  eigenvalue  analysis. 


NAME 

TYPE/KEY 

DESCRIPTION 

_ _ _ _ _ _ — - 

METHOD 

IbxtiS) 

Method  of  real  eigenvalue  extraction  | 

NITER 

Integer 

Design  iteration  number 

BCID 

Integer 

Boundary  condition  number 

NLAMA 

Integer 

Number  of  eigenvalue 

NVECTOR 

Integer 

number  of  eigenvectors 

NEVER 

Integer 

Number  of  eigenvalue  errors 

NVER 

integer 

Number  of  eigenvector  errors 

NOSTRT 

Integer 

Number  of  passes  through  the  starting 
points 

NOMOVS 

Integer 

Number  of  starting  point  moves 

NODCMP 

Integer 

Number  of  decomposition 

ITER 

Integer 

Total  number  of  iterations 

I  ITERM 

Integer 

Reason  for  termination 

1  XMAXl 

Real 

Maximum  off  diagonal  mass  term 

I STORE 

Integer 

The  row  number  at  which  the  maximum 
off  diagonal  mass  term  is  located  | 

JSTORE 

Integer 

The  column  number  at  which  the 

TT^aYiTniim  off  diagonal  mass  term  is  located  | 

IMSG 

Integer 

Number  of  off  diagonal  mass  terms  | 

TITLE 

'Itext(72) 

n 

SUBTITLE 

'Ibxt(72) 

Not  used  1 

LABEL 

'Ifext(72) 

J 

Module  REIG 
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Entity: 

Entity  lype: 
Description: 
Relation  Attributes: 


Created  By: 


OEULBUCK 

Relation 

Contains  Euler  buckling  constraint  output. 


NAME 

TYPE/KEY 

DESCRIPTION 

BCID 

Integer 

Boundary  condition  number  j 

DISC 

Integer 

Discipline  flag  j 

ITER 

Integer 

Design  iteration  number  || 

SID 

Integer 

Constraint  set  identification  number  j 

SUBCASE 

integer 

Subcase  number 

EID 

Integer 

Element  identification  number 

ETYPE 

Tfext(8) 

Element  type 

BNDCON 

Text(8) 

Boundary  condition  t3rpe 

PAIXAL 

Real 

Intermediate  rsult  in  constraint 
computation 

LAMBDA 

Real 

Ejdxacted  eigenvalue 

BKMODE 

IfextCS) 

Buckling  mode 

CVAL 

Real 

Constraint  value  j 

LENGTH 

Real 

Rod  buckling  length  j 

Module  EBKLEVAL 
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Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


OGPWG 

Relation 

Contains  data  from  the  grid  point  weight  generation  computations. 


NAME 

TYPE/KEY 

DESCRIPTION 

NITER 

Integer 

Iteration  number 

BCID 

Integer 

Boundaiy  condition  number 

GREF 

Integer 

Grid  point  identification  (or  zero) 

XO 

Real 

Basic  coordinates  of  the  reference  point 

YO 

Real 

ZO 

Real 

MO 

R  Vector(36) 

Mass  matrix  at  the  reference  point 

S 

R  Vector(9) 

Principal  axes  relative  to  basic  system 

MX 

Real 

Mass  in  the  x-axis  direction  1 

RX 

R  Vector(3) 

x,y,z  coordinates  of  the  x-axis  c.g. 

MY 

Real 

Mass  in  the  y-axis  direction 

RY 

R  Vector(3) 

x,y,z  coordinates  of  the  y-axis  c.g. 

Real 

Mass  in  the  z-axis  direction 

RZ 

R  Vector(3) 

x,y,z  coordinates  of  the  z-axis  c.g. 

INERTIA 

R  Vector(9) 

Matrix  of  inertias 

PINERTIA 

R  VectorO) 

Principal  inertias  about  x 

R  Vector(9) 

Components  of  tiie  principal  axes 

Module  GPWG 
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Entity: 

Entity  TVpe: 
Description: 

Relation  Attributes: 


06RIDDSP 

Relation 

Contains  the  displacements  of  the  physical  degrees  of  freedom  that  are  requested 
for  print  or  punch  in  Solution  Control. 


NAME 

TYPE/KEY 

DESCRIPTION 

NITER 

Integer 

Iteration  number 

BCID 

Integer 

The  boundary  condition  number 

DISC 

Integer 

Discipline  flag 

=  1  Statics  =  5  Transient 

=  2  Modes  =  6  Frequency 

=  3  Steady  Aero  =  7  Buckling 

=  4  Flutter  =  8  Blast 

SUBCASE 

Integer 

Subcase  identification  number 

DISPTYPE 

Ifext  (8) 

Label  identifying  the  type  of  the 
displacement  (See  Remark  1) 

CMPLX 

Integer 

Real  or  complex  flag 
=  1  if  real  displacement 
=  2  if  complex  displacement 

GRIDID 

Integer 

External  identification  number  of  the 
physical  point 

SIL 

Integer 

Internal  identification  number  of  the 
physical  point 

FLAG 

Integer 

Flag  indicating  whether  the  point  is  a  grid 
point  or  a  scalar  point 
=  0  for  extra  points 
=  1  for  scalar  points 
=  6  for  structural  nodes 

RDISP 

Real  Vector  (6) 

Real  part  of  the  displacement 

IDISP 

Real  Vector  (6) 

Imaginary  part  of  the  displacement 

Created  By: 
Notes: 


Many  Modules 


1.  The  DISPTYPE  is  a  textual  key  that  identifies  the  displacement  terms.  The 
following  values  are  used: 

DISPLACE  -  Displacements  of  the  structural  degrees  of  freedom. 

VELOCITY  -  Velocities  of  the  structural  degrees  of  freedom 

ACCEL  -  Accelerations  of  the  structiural  degrees  of  freedom. 
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Entity; 

Entity  Type; 
Description; 

Relation  Attributes: 


Created  By: 
Notes: 


OGRIDLOD 

Relation 

Contains  the  applied  loads,  reaction  forces  and  other  loads  on  the  physical  degrees 
of  freedom  that  are  requested  for  print  or  punch  in  Solution  Control. 


1  NAME 

TYPE/KEY 

DESCRIPTION 

1  NITER 

Integer 

Iteration  number 

BCID 

Integer 

The  boundary  condition  number 

DISC 

Integer 

Discipline  flag 

=  1  Statics  =  5  Transient 

=  2  Modes  =  7  Buckling 

=  3  Steady  Aero  =  8  Blast 

SUBCASE 

Integer 

Subcase  identification  number 

LOADTYPE 

Ifext  (8) 

Label  identifying  the  t3q)e  of  the  load  (see 
remark  1) 

CMPLX 

Integer 

Real  or  complex  flag 
=  1  if  real  load 
=  2  if  complex  load 

GRIDID 

Integer 

External  identification  number  of  the 
physical  point 

SIL 

Integer 

Internal  identification  number  of  the 
physical  point 

FLAG 

Integer 

Flag  indicating  whether  the  point  is  a  grid 
point  or  a  scalar  point 
=  0  for  extra  point 
=  1  for  scalar  point 

=  6  for  structural  nodes  \ 

RFORCE 

Real 

Real  part  of  the  applied  load 

I FORCE 

Real 

Imaginary  part  of  the  applied  load  | 

Many  Modules 


1.  The  LOADTYPE  is  a  textual  key  that  identifies  the  load  terms. 
The  following  values  are  used: 


APPLIED 


RIGID 

FLEXIBLE 

INERTIA 

SPC 


User  defined  apphed  load  from  all  disciplines.  For  SAERO, 
the  APPLIED  load  is  computed  and  stored  as  the  sum  of 
RIGID,  FLEXIBLE  and  INERTIA  loads. 

Trimmed  rigid  aerodynamic  load  from  SAERO 
Trimmed  flexible  contribution  to  aerodynamic  load  from 
SAERO 

Inertia  load  contribution  from  SAERO  and  STATICS  with  in- 

SPC  reaction  forces  for  STATICS,  SAERO,  MODES,  TRAN¬ 
SIENT  and  FREQUENCY. 
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Entity: 

Entity  lype: 
Description: 

Relation  Attributes : 


Created  By: 
Notes: 


OLOCALDV 

Relation 

Contains  the  local  design  variable  values  that  are  requested  for  print  or  pxinch  in 
Solution  Control. 


NAME 

TYPE/KEY 

DESCRIPTION 

NITER 

Integer 

Iteration  number 

ETYPE 

Text  (8) 

Element  type,  one  of  the  following: 

BAR  CONM2 

ELAS  MASS 

QDMEMl  QUAD4 

ROD  SHEAR 

TRIAS  TRMEM 

EID 

Integer  >  0 

Element  identification  number 

LAYRNUM 

Integer 

Layer  number  (=0  if  noncomposite) 

DVSYMBL 

Text(8) 

Designed  dimension  sjmibol 
(Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9,  DIO 
for  BAR  element  cross  section 

dimension;  A  for  element  area,  T  for 
element  thickness;  M  for  element  mass;  K 
for  element  stiffiiess.) 

T 

Real 

Local  design  variable  value  (See  Remark  2) 

11 

Real 

1st  plane  moment  of  inertia  for  BAR 
elements 

12 

Real 

2nd  plane  moment  of  inertia  for  BAR 
elements 

Module  ACTCON 

1.  Any  local  design  variable  that  are  requested  for  print  or  punch  in  Solution 
Control  at  any  iteration  will  be  stored  in  this  relation. 

2.  For  each  element  type,  T,  II  and  12  have  different  meanings 


BAR 

-  T  is  element  cross-sectional  area 

11  and  12  are  related  moments  of  inertia 

CONM2 

-  T  is  concentrated  mass  value 

11  and  12  are  not  used 

ELAS 

-  T  is  spring  stif&iess 

11  and  12  are  not  used 

MASS 

-  T  is  mass  value 

11  and  12  are  not  used 

QDMEMl 

-  T  is  element  or  layer  thickness 

11  and  12  are  not  used 

QUAD4 

-  T  is  element  or  layer  thickness 

11  and  12  are  not  used 
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ROD  -  T  is  element  cross  sectional  area 

II  and  12  are  not  used 
SHEAR  -  T  is  element  thickness 
II  and  12  are  not  used 

TRIA3  -  T  is  element  or  layer  thickness 
II  and  12  are  not  used 

TRMEM  -  T  is  element  or  layer  thickness 
II  and  12  are  not  used 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


OMIT 

Relation 

Contains  the  definition  of  the  degrees  of  freedom  that  the  user  wishes  to  omit  from 
the  analysis  through  matrix  reduction. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number  | 

GRIDl 

Integer  >  0 

Grid  or  scalar  point  id  [ 

COMPNTSl 

Integer  >  0 

Component  of  GRIDl  to  be  omitted  | 

Module  IFF 

1.  Used  by  the  MKUSET  module  to  build  the  USET  relation. 

OMITl 

Relation 

Contains  the  definition  of  the  degrees  of  freedom  that  the  user  wishes  to  omit  from 
the  analysis  through  matrix  reduction. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

SETID 

Integer  >  0 

Set  identification  number 

COMPNTSl 

Integer  >  0 

Component  of  GRIDl  to  be  omitted 

GRIDl 

Integer  >  0 

Grid  or  scalar  point  id 

Module  IFF 

1.  Used  by  the  MKUSET  module  to  build  the  USET  relation. 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 
Entity  Type: 
Description: 
Record: 

Created  By: 
Notes: 


OPNLBUCK 

Relation 

Contains  panel  buckling  constraint  output. 


NAME 

TYPE/KEY 

DESCRIPTION 

BCID 

Integer 

Boundary  condition  number 

DISC 

Integer 

Discipline  flag 

ITER 

Integer 

Design  iteration  nmnber 

SID 

Integer 

Constraint  set  identification  number 

SUBCASE 

integer 

Subcase  number 

EID 

Integer 

Element  identification  number 

ETYPE 

Text(8) 

Element  type 

NX 

Real 

Element  force 

NY 

NXY 

SHIFT 

Real 

Shifting  points  adopted  by  power  method 

LAMBDA 

Real 

Extracted  eigenvalue 

BKMODE 

Text(8) 

Buckling  mode 

CVAL 

Real 

Constraint  value  1 

LENGTH 

Real 

Panel  buckling  length 

WIDTH 

Real 

Panel  buckling  width  1 

Module  PBKLEVAL 

OTL 

Unstructured 

Contains  a  list  of  output  times  for  each  time  step  set. 

1.  Contains  a  list  of  the  LIDs  of  the  time  ste^  sets  in  the  Bulk  Data  file, 
i.  Contains  the  output  time  fist  for  the  (i-1)  set  ID. 

Module  PFBULK 

1.  This  entity  is  used  in  the  OFPxxx  modules. 
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Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


OPTIMIZE 

Relation 

Contains  the  optimization-dependent  solution  control  requests  as  input  in  the 
solution  control  packet. 


NAME 

TYPE/KEY 

DESCRIPTION 

CGRAPRNT 

Integer  vector  (20) 

Constraint  gradient  print  selection 
WORD  1  Print  set  identification 
number  >  0,  or 
=  0  NONE 
=  -lALL 
= -2  LAST 
=  -3  ACTIVE 

WORD  2  Punch  set  identification 
number 

WORD  3  Print  form 
=  0  Rectangular 
=  1  Polar 

WORD  4  Pimch  form 

WORD  5  Print  frequency  set 
identification  number 

WORD  6  Pxmch  frequency  set 
identification  number 

WORD  7  Print  iteration  set 
identification  number 

WORD  8  Pimch  iteration  set 
identification  number 

WORD  9  Print  mode  set  identification 
number 

WORD  10  Pimch  mode  set 
identification  number 

WORD  11  Print  time  set  identification 
number 

WORD  12  Punch  time  set  identification 
number 

WORD  13-20  unused 

OBJID 

Integer 

Objective  function  identification  number 

DCONFID 

Integer 

Subcase-independent  user  function 
constraint  identification  number 

OBJDIR 

Text  (4) 

MIN  for  MINIMIZE 

MAX  for  MAXIMIZE 

DCONPRNT 

Integer  vector  (20) 

Design  constraint  print  selection 

GDESPRNT 

Integer  vector  (20) 

Global  design  variable  print  selection 

KSNSPRNT 

Integer  vector  (20) 

Element  stiffiiess  senstivity  print 
selection 
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Created  By: 
Notes: 


Entity: 
Entity  Type: 
Description: 

Entity: 
Entity  Type: 
Description: 


NAME 

TYPE/KEY 

DESCRIPTION 

LDESPRNT 

Integer  vector  (20) 

Local  design  variable  print  selection 

MSNSPRNT 

Integer  vector  (20) 

Element  mass  senstivity  print  selection 

OGRAPKNT 

Integer  vector  (20) 

Objective  function  gradient  print 
selection 

BULKPKNT 

Integer  vector  (20) 

Design  model  Bulk  Data  punch 
selection 

HISTPRNT 

Integer 

Design  iteration  history  print  toggle 

TITLE 

Tfext  (72) 

User  label  TITLE 

SUBTITLE 

Ifext  (72) 

User  label  SUBTITLE 

LABEL 

Ifext  (72) 

User  label  LABEL 

Module  Solution 

1.  The  format  of  the  CGRAPRNT  vector  is  typical  of  the  format  of  all  the  print 
selection  vectors.  Additionally,  the  format  for  the  print  set  Identification  num¬ 
ber  in  the  CGRAPRNT  vector  is  typical  of  that  of  the  other  set  Identification 
numbers  in  the  vector. 

2.  The  CASE,  JOB  and  OPTIMIZE  relation  entities  together  contain  the  solu¬ 
tion  control  requests  as  input  in  the  solution  control  packet.  CASE  contains 
the  case-dependent  parameters,  JOB  contains  the  case-independent  requests 
and  OPTIMIZE  contains  the  optimization-dependent  requests. 


PA 

Matrix 

External  loads  applied  in  the  a-set  derived  from  partitions  of  PF  (see  PG). 


PAA 

Matrix 

Rigid  body  aerodynamic  load  vectors  derived  fi:om  partitions  of  PAF  (see  PAF). 


Entity: 

Entity  Type; 
Description; 

Relation  Attributes: 


Created  By: 
Notes: 


PAEROl 

Relation 

Contains  a  list  of  associated  bodies  for  panels  used  in  Doublet-Lattice  aerodynamics. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0 

Property  identification  number 

BODIES 

Integer  Array  (6) 

Array  attribute  containing  the 
identifications  of  associated  bodies 

Module  IFF 

1.  The  BODIES  identification  numbers  refer  to  CAER02  relation  tuples. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


PAER02 

Relation 

Contains  the  definition  of  the  cross-sectional  properties  of  Doublet-Lattice  aerody¬ 
namic  bodies  as  input  from  the  bulk  data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0 

Property  identification 

ORIENT 

Ttext  (8) 

Type  of  motion  allowed  for  the  body 

WIDTH 

Real  >  0.0 

Reference  half  width  for  the  body 

1 

Real  >  0.0 

Aspect  ratios  for  the  body 

LRSB 

Integer  >  0 

AEFACT  identification  number  containing 
the  half  widths  of  slender  bodies 

LRIB 

Integer  >  0 

AEFACT  identification  number  containing 
the  half  widths  of  interference  bodies 

LTHl 

Integer  >  0 

AEFACT  identification  number  that  has  | 

the  first  array  of  theta  values 

LTH2 

Integer  >  0 

AEFACT  identification  number  that  has 
the  second  array  of  theta  values 

THIl 

Integer  >  0 

First  interference  element  using  the 

LTHl  theta  distribution 

THNl 

Integer  >  0 

Last  interference  element  using  the 

LTHl  theta  distribution 
_ _ _ 

THI2 

Integer  >  0 

First  interference  element  using  the 

LTH2  theta  distribution 

THN2 

Integer  >  0 

Last  interference  element  using  the 

LTH2  theta  distribution  1 

THI3 

Integer  >  0 

First  interference  element  after  THN2  that  | 
uses  the  LTHl  theta  distribution 

THN3 

Integer  >  0 

Last  interference  element  after  THN2  that  I 
uses  the  LTHl  theta  distribution  j 

Module  EFP 
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Entity: 

Entity  TVpe: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 
Entity  Type: 
Description: 
Matrix  Form: 
Created  By: 
Notes: 


Entity: 
Entity  Type: 
Description: 


PAER06 

Relation 

Contains  the  definition  of  analysis  parameters  for  bodies  in  the  aerod3niamic  model 
as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

BCID 

Integer  >  0 

Body  component  identification  number 

ACMPNT 

Ifext  (8) 

Component  type  (i.e.  FUSEL) 

CP 

Integer  >  0 

Coordinate  system  in  which  geometry 
inputs  are  given 

GROUP 

Integer  >  0 

Group  identification  number 

NRAD 

Integer  >  0 

Number  of  equal  radial  cuts  used  to  define 
body  panels 

LRAD 

Integer  >  0 

AEFACT  set  identification  number  for  the 
angular  locations  of  body  panels 

AXIAL 

Integer  >  0 

AEFACT  set  identification  number  for  the 
axial  locations  of  body  panels 

Module  IFP 


PAF 

Matrix 

Rigid  body  load  vectors  multiplied  by  dynamic  pressure. 

See  AIRFRC  for  the  dimensions. 

MAPOL 

1.  This  matrix  is  the  dynamic  pressure  times  AIRFRC. 

2.  The  MAPOL  sequence  supports  the  following  partitions  of  the  PAF  matrix 
(see  the  Theoretical  Manual  for  the  explicit  formation  of  these  submatrices): 


PAL 


Matrix 

A  partition  of  PAA  (see  PAF). 
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Entity: 

Entity  lype: 
Description: 

Matrix  Form: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


PAR 

Subscripted  Matrix 

An  intermediate  matrix  formed  during  the  performance  of  an  aeroelastic  trim 
analysis. 

The  number  of  rows  is  equal  to  the  number  of  degrees  of  freedom  in  the  1-set  while 
the  number  of  columns  is  equal  to  the  number  of  rigid  body  load  vectors  from 
AIRFRC. 

MAPOL  using  GFBS 

1.  PAR  is  the  solution  of: 

[KAll] [PAR]  =  [PI] 

2.  Since  PAR  is  needed  in  the  sensitivity  analysis,  it  is  subscripted  by  boundary 
condition. 

PARBAR 

Matrix 

A  partition  of  the  PAA  (see  PAF). 

PARL 

Subscripted  Matrix 

Contains  the  partitioning  vector  to  partition  those  degrees  of  retained  for  analysis 
(a-set)  into  those  reduced  out  (r-set)  and  those  left  over  (1-set). 

A  variable-sized  single  precision  column  vector  having  one  row  for  each  degree  of 
freedom  retained  for  analysis.  Degrees  of  freedom  in  the  reduce  set  are  denoted  by 
a  real  0.0  and  those  left  over  by  a  real  1.0. 

Module  MKUSET 

1.  The  dimension  of  this  subscripted  matrix  must  be  large  enough  for  aU  optimi¬ 
zation  and  analysis  boundary  conditions. 

2.  This  vector  is  modified  by  the  GDR  modules  if  Generalized  Dynamic  Reduc¬ 
tion  is  used. 
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PBAR 


Entity: 

Entity  I^pe: 
Description: 

Relation  Attributes: 


Created  By: 


Relation 


Contains  the  property  definition  for  the  BAR  element  as  input  from  the  Bulk  Data 
file. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0,  key 

Property  identification  number 

MIDI 

Integer  >  0 

Material  property  identification 
number  of  the  MATl  tuple 

AREA 

Real  >  0.0 

Element  cross-sectional  area 

11 

Real 

Area  moment  of  inertia  in  plane  1 

12 

Real 

Area  moment  of  inertia  in  plane  2 

TORSION 

Real 

Ibrsional  constant 

NSM 

Real  >  0.0 

Element  nonstructural  mass 

TMIN 

Real 

Minimum  cross-sectional  area  in 
design 

Cl,  C2,  Dl,  D2 

Real 

Element  stress  recovery  coefficients 

El,  E2,  FI,  F2 

Real 

KFACTl 

Real 

Area  factor  for  shear  (plane  1) 

KFACT2 

Real 

Area  factor  for  shear  (plane  2) 

112 

Real 

Area  product  of  inertia  1 

RISQR 

Real 

MultipUcative  factor  to  determine  | 
11  in  design  | 

R2SQR 

Real 

Multiplicative  factor  to  determine 

12  in  design  1 

ALPHA 

Real 

Exponential  power  associated  with 
the  design  variable. 

Module  IFF 
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Entity; 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type; 
Description: 
Entity  Structure: 

Created  By: 
Notes: 


FBARl 

Relation 

Contains  the  property  definition  for  the  BAR  element  as  input  from  the  Bulk  Data 
file. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0,  key 

Property  identification  nxxmber 

MID 

Integer  >  0 

Material  property  identification 
number  of  the  MATl  tuple 

SHAPE 

Tfext(8) 

Element  cross-section  shape 

D1 

Real  >  0.0 

Element  cross-section  dimension  1 

D2 

Real  >  0.0 

Element  cross-section  dimension  2 

D3 

Real  >  0.0 

Element  cross-section  dimension  3 

D4 

Real  >  0.0 

Element  cross-section  dimension  4 

D5 

Real  >  0.0 

Element  cross-section  dimension  5 

— - 

D6 

Real  >  0.0 

Element  cross-section  dimension  6 

D7 

Real  >  0.0 

Element  cross-section  dimension  7 

D8 

Real  >  0.0 

Element  cross-section  dimension  8 

D9 

Real  >  0.0 

Element  cross-section  dimension  9 

DIO 

Real  >  0.0 

Element  cross-section  dimension  10 

NSM 

Real  >  0.0 

Non  structural  mass 

Module  IFF 

PCAS 

Unstructured 

Identifies  active  constraints  for  the  current  boundary  condition. 

A  single  record  of  integers  whose  length  is  equal  to  the  number  of  constraints  active 
in  the  current  boundary  condition. 

Module  ABOUND 

1.  There  is  one  integer  for  each  active  constraint.  The  integer  is  set  to  the  sub¬ 
case  number  of  the  constraint  (see  the  CONST  relation). 
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Entity: 

Entity  T^pe: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


PCOMP 

Relation 

Contains  the  property  definitions  for  a  multiple  ply  composite  material  laminate  as 
input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0 

Property  identification  number 

ZO 

Real 

The  distance  from  the  plane  of  the  grid 
points  to  the  bottom  surface 

NSM 

Real  >  0.0 

nonstructural  mass  per  unit  area 

SBOND 

Real  >  0.0 

Allowable  shear  stress  of  bonding  material 

FAILCRIT 

Thxt  (8) 

Theory  used  to  predict  failure 

TMIN 

Real 

Minimum  layer  thicknesses  for  design 

LOPT 

Text  (8) 

Laminate  generation  option 

MIDI 

Integer  >  0 

Ply  material  identification 

THICKI 

Integer  >  0 

Ply  thickness 

THETAI 

Real 

Ply  material  orientation  angle 

SOUTI 

Ifext  (8) 

Flag  for  stress  output 

Module  IFF 

1.  This  relation  will  contain  one  tuple  for  each  ply  in  each  unique  FID. 
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Entity: 

Entity  Type: 
Description: 

Entity  Structure: 


Created  By: 


PCOMPS 

Unstructured 

Contains  one  record  for  each  PCOMPi  Bulk  Data  type  entry.  Data  includes  the 
PCOMPi  entry  and  its  intrinsic  laminate  property  data. 


Record 

Word 

Type 

Description 

1 

1-2 

Tfext 

PCOMP 

3 

Integer  >  0 

PID-Property  identification 
number 

4 

Integer  >  0 

N-Number  of  layers 

5(11+4*N) 

RSP 

Remainder  of  PCOMP  data 

(12+4*N)-(31*N+11) 

RSP 

Layer  Property  data 

(31*N+12)-(31*N+13) 

RSP 

Laminate  Bending  Inertia 

(31*N+14)-(31*N+15) 

RSP 

Laminate  Neutral  Surface 
Location 

1  Words  3  through  31*N+15  are  repeated  for  each  PCOMP  Bxilk  Data  entry.  \ 

2 

1-2 

Tfext 

PCOMPI 

3 

Integer  >  0 

PID-Property  identification 
number 

4 

Integer  >  0 

N-Numbers  of  layers 

5-(12+N) 

RSP 

Remainder  of  PCOMPI  data 

(13+N)-(37+N) 

RSP 

Layer  property  data 

(38+N)-(39+N) 

RSP 

Laminate  Bending  Inertia 

(40+N)-(41+N) 

RSP 

Laminate  Neutral  Surface 
Location 

1  Words  3-4 1+N  are  repeated  for  each  PCOMPI  Bulk  Data  entiy. 

3 

1-2 

Text 

PCOMP2 

3 

Integer  >  0 

PID-Property  identification 
niunber 

4 

Integer  >  0 

N-Number  of  layers 

5-(ll+2*N) 

RSP 

Remainder  of  PCOMP2  data 

(12+2*N)-(36+2*N) 

RSP 

Layer  property  data 

(37+2*N)-(38+2*N) 

RSP 

Laminate  Bending  Inertia 

(39+2*N)-(40+2*N) 

RSP 

Laminate  Neutral  Surface 
Location 

1  Words  3-40+2*N  are  repeated  for  each  PCOMP2  Bulk  Data  entry.  1 

Module  EMG 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


PCOMPl 

Relation 

Defines  the  property  of  a  n-ply  laminated  composite  material  where  aU  plies  are 
composed  of  the  same  material  and  are  of  equal  thickness. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0 

Property  identification  number 

ZO 

Real 

Offset  of  the  element  reference  plane  firom  the 
plane  of  grid  points 

NSM 

Real  >  0.0 

nonstructural  mass  per  unit  area 

SBOND 

Real  >  0.0 

Allowable  shear  stress  of  the  bending  material. 

FAILCRIT 

Tbxt  (8) 

Failmre  theory  to  predict  ply  failure 

TMIN 

Real  >  0.0 

Minimum  layer  thickness  for  design 

MID 

Integer  >  0 

Ply  material  identification 

LOPT 

Tfext  (8) 

Lamination  generation  option 

THICK 

Real  >  0.0 

Ply  thickness 

THETAI 

Real 

Ply  material  orientation  angle 

Module  IFF 


1.  This  relation  will  contain  one  tuple  for  each  ply  for  each  unique  FID. 
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Entity: 

EntityType; 

Description: 

Relation  Attributes: 


Created  By: 
Notes: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


FCOMP2 

Relation 

Defines  the  properties  of  a  n-ply  laminated  composite  material  where  all  plies  are 
of  the  same  material. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0 

Property  identification  number 

ZO 

Real 

Offset  of  the  element  reference  plane  from 
the  plane  of  grid  points. 

NSM 

Real  >  0.0 

Nonstructural  mass  per  unit  area 

SBOND 

Real  >  0.0 

Allowable  shear  stress  of  the  bonding 
material. 

FAILCRIT 

Tfext  (8) 

Failure  theory  to  predict  ply  failiire 

TMIN 

Real  >  0.0 

Minimum  layer  thickness  for  design 

MID 

Integer>  0.0 

Ply  material  identification 

LOPT 

Text  (8) 

Lamination  generation  option 

THICKI 

Real  >  0.0 

Ply  thickness 

THETAI 

Reeil 

Ply  material  orientation  angle  || 

Module  IFF 

1.  The  relation  will  contain  one  tuple  for  each  ply  for  each  unique  FID. 


PDF 

Matrix 

Applied  loads  matrix  for  frequency  response  analysis. 

Complex  matrix  with  one  column  for  each  frequency  at  which  frequency  response 
results  are  to  be  computed.  This  matrix  is  apphcable  for  both  the  direct  and  modal 
methods  of  solution  so  that  the  number  of  rows  equal  to  the  number  of  degrees  of 
freedom  in  the  d-  or  h-sets,  depending  on  the  method  of  solution. 

Module  DYNLOAD 

1.  This  matrix  is  also  for  applied  gust  loads  if  the  gust  discipline  option  of  fre¬ 
quency  response  is  selected. 
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Entity: 

Entityiype: 

Description: 


Created  By: 


PDLIST 

Relation 

Contains  the  panel  buckling  constraint  sensitivity  parameters. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

NITER 

Integer  >  0 

Iteration  number  1 

BCID 

Integer  >  0 

Boundary  condition  identification  number  | 

DISFLAG 

Integer  >  0 

Discipline  type  flag  fi-om  CASE  relation  (where 
appropriate) 

PNUM 

Integer  >  0 

Pointer  number  firom  CONST  for  sensitivity 
computation 

SID 

Integer  >  0 

Set  identification  number  of  panel  buckling 
constraints 

UPLOW 

Text  (8) 

Constraint  t3^e  (Upper/Lower) 

POWER 

Real 

Internal  constraint  formulation  factor 

PID 

Integer 

Element  property  identification  number 

PTYPE 

Text(8) 

Element  property  type 

MID 

Integer 

Element  material  identification  number 

MTYPE 

Tlsxt(8) 

Element  properly  type  (PCOMPS/PSHELL) 

THICK 

Real 

Element  thickness 

DCVAL 

Real 

Intermediate  result  in  constraint  computation 

LAMBDA 

Real 

Extracted  eigenvalue 

PDll 

Real 

Intermediate  results  for  sensitvity  computation 

PD12 

PD13 

PD22 

PD23 

PD33 

Module  PBKLEVAL 
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Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Entity: 
Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


PDT 

Matrix 

Applied  loads  matrix  for  transient  response  analysis. 

Complex  matrix  with  one  column  for  each  frequency  at  which  transient  response 
results  are  to  be  computed.  This  matrix  is  applicable  for  both  the  direct  and  modal 
methods  of  solution  so  that  the  number  of  rows  equal  to  the  number  of  degrees  of 
freedom  in  the  d-  or  h-sets,  depending  on  the  method  of  solution. 

Module  DYNLOAD 

PELAS 

Relation 

Contains  the  property  data  for  scalar  spring  elements  as  input  from  the  Bulk  Data 
file. 


NAME 

TYPE/KEY 

DESCRIPTION  I 

PID 

Integer,  key 

Property  identification  number  j 

K 

Real 

Spring  constant 

DAMPCOEF 

Real 

Damping  coefficient 

STRSCOEF 

Real 

Stress  coefficient 

TMIN 

Real 

Minimum  spring  constant  value  for  design 

Module  IFF 

PF 

Matrix 

External  loads  in  the  f-set  derived  from  partitions  of  PN  (see  PG). 


PF6LOAD 

Matrix 

Apphed  loads  matrix  on  the  physical  degrees  of  freedom  for  the  frequency  dependent 
loads  in  the  current  boundary  condition. 

Complex  rectangular  matrix  with  one  row  for  each  physical  degree  of  freedom  and 
one  column  for  each  frequency  step  in  each  frequency  analysis  in  the  current 
boundary  condition. 

Module  DYNLOAD 

1.  This  matrix  is  formed  only  if  the  LOAD  print  request  for  the  FREQUENCY 
discipline  is  set  for  the  current  boundary  condition. 
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PFOA 


Entity: 

Entity  T^pe: 
Description: 

Matrix  Form: 


Created  By: 
Notes: 


Subscripted  Matrix 

Contains  the  partitioning  vector  to  partition  the  free  degrees  of  freedom  (f-set)  into 
the  omitted  degrees  of  freedom  (o-set)  and  those  retained  for  analysis  (a-set). 

A  variable-sized  smgle-precision  column  vector  containing  one  row  for  every  free 
degree  of  freedom.  Degrees  of  freedom  in  the  o-set  are  denoted  by  real  0.0  and  those 
in  the  a-set  by  real  1.0. 

Module  MKUSET 

1.  The  dimension  of  this  subscripted  matrix  must  be  large  enough  for  all  optimi¬ 
zation  and  analysis  boundary  conditions. 

2.  This  matrix  is  modified  by  the  GDR  modules  if  Generahzed  Dynamic  Reduc¬ 
tion  is  used. 


Entity: 


P6 


Entity  T^pe: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Matrix 

Contains  the  global  loads  matrix  for  the  current  boundary  condition. 

A  variable-size  matrix  having  one  row  for  each  structural  degree  of  freedom  in  the 
model  and  one  coliimn  for  each  load  condition  in  the  current  boundary  condition. 

Module  GTLOAD 


1. 

2. 


This  matrix  is  flushed  and  re-formed  for  each  boundary  condition  in  the  prob¬ 
lem. 

The  MAPOL  sequence  supports  the  following  partitions  of  the  PG  matrix  (see 
Theoretical  Manual  for  the  explicit  formation  of  these  submatrices). 


PG 

PF 


PM 

PA 


PS  I 
PF 

PR 

PLBAR 


PGA 

Matrix 

Partitioning  vector  for  active  load  cases. 


One  column  with  the  numbers  of  rows  equal  to  the  number  of  subcases  for  the 
current  boimdaiy  condition. 


Module  ABOUND 


1.  Active  subcases  are  designated  by  a  value  of  1.0,  inactive  subcases  by  0.0. 


714 


Entity: 

Entity  TVpe: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 


P6MN 

Subscripted  Matrix 

Contains  the  partitioning  vector  to  partition  the  structural  degrees  of  freedom 
(g-set)  into  the  dependent  multi-point  constraint  set  (m-set)  and  the  independent 
set  (n-  set). 

A  variable-sized  single  precision  column  vector  containing  one  row  for  each  struc¬ 
tural  degree  of  freedom  in  the  model.  Degrees  of  freedom  in  the  m-set  are  denoted 
by  real  0.0  and  those  in  the  n-set  by  real  1.0. 

Module  MKUSET 

PHIA 

Matrix 

Contains  the  eigenvectors  in  the  analysis  degrees  of  freedom  for  each  vector 
computed. 

A  variable-sized  vector  having  one  column  for  each  computed  eigenvector  and  one 
row  for  each  degree  of  freedom  in  the  analysis  set  for  the  current  boundary  condition. 

Module  REIG 

1.  See  PHIG  for  data  recovery. 

PHIB 

Matrix 

Matrix  of  mode  shapes  used  in  nuclear  blast  response. 

Real  rectangular  matrix  with  one  row  for  each  a-set  degree  of  freedom  and  one 
column  for  each  retained  mode. 

MAPOL 

1.  PHIB  is  obtained  by  merging  PHIR  and  PHIE. 

PHIE 

Matrix 

Matrix  of  elastic  mode  shapes  used  in  nuclear  blast  response. 

Real  rectangular  matrix  with  one  row  for  each  a-set  degree  of  freedom  and  one 
column  for  each  retained  elastic  mode. 

MAPOL 


Entity: 
Entity  T^pe: 
Description: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 


PHIF 

Matrix 

Normal  modes  in  the  f-set  recovered  from  PHIA  and  PHIO  (see  PHIG). 

PHI6 

Subscripted  Matrix 

Contains  the  eigenvectors  in  the  global  set  computed  in  the  REIG  module. 

A  variable-sized  matrix  having  one  column  for  each  eigenvector  computed  and  one 
row  for  each  structural  degree  of  freedom. 

MAPOL 


1. 


The  MAPOL  sequence  recovers  this  matrix  in  the  following  order: 


[PHIO] 

r  PHIA 
PHIO 

r  YS 

PHIF 

[DM*] 

X3M 

PHIN 


[GSDBO]  [PHIA] 
PHIF 

PHIN 

[THN]  [PHIN] 
PHIG 


*UM  contains  modes  in  the  m-set.  The  entity  is  reused  in  the  MAPOL  se¬ 
quence. 


PHIKH 

Matrix 

Normal  mode  shapes  splined  to  the  aerodynamic  panels. 

Real  rectangular  matrix  with  one  row  for  each  aerod3mamic  degree  of  freedom  and 
one  coliunn  for  each  normal  mode. 

Module  QHHLGEN 


PHIN 

Matrix 

Modes  in  the  n-set,  recovered  from  PHIF  (see  PHIG). 


PHIO 

Matrix 

Mode  shapes  for  omitted  degrees  of  freedom  (see  PHIG). 
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Entity: 

Entity  l^pe: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


PHIOK 

Matrix 

Approximate  mode  shapes  produced  by  generalized  dynamic  reduction. 

Real  rectangular  matrix  with  one  row  for  each  o-set  degree  of  freedom  and  one 
column  for  each  approximate  mode  shape. 

Module  GDR2 

1.  This  matrix  is  computed  for  generalized  dynamic  reduction  and  only  if  there 
are  k-set  degrees  of  freedom. 

PHIR 

Matrix 

Matrix  of  rigid  body  shapes  used  in  nuclear  blast  response. 

Real  rectangular  matrix  with  one  row  for  each  a-set  degree  of  freedom  and  one 
column  for  each  retained  rigid  body  mode. 

MAPOL 

1.  This  matrix  is  created  by  performing  a  ROWMERGE  using  matrices  D  and 
ID2  and  partiton  vector  MPART. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 

Entity: 
Entity  Type: 
Description: 


FIHEX 

Relation 

Contains  the  property  data  for  an  isoparametric  hexahedron  element  as  input  from 
the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0,  key 

Property  identification  number 

MID 

Integer  >  0 

Material  identification  number 

CID 

Integer  >  0 

Identification  number  of  the  coordinate 
system  in  which  the  material  referenced  by 
MID  is  defined 

NIP 

Integer  =  2,  3,  4 

Number  of  integration  points  along  each 
edge  of  the  element 

AR 

Real  >  1.0 

Maximum  aspect  ratio  (ratio  of  longest  to 
shortest  edge)  of  the  element 

ALFA 

Real, 

0.0<ALFA<180.0 

Maximum  angle  in  degrees  between  the 
normals  of  two  subtriangles  comprising  a 
quadrilateral  face 

BETA 

Real, 

0.0^ETA<180.0 

Maximum  angle  in  degrees  between  the 
vector  connecting  a  comer  point  to  an 
adjacent  midside  point  and  the  vector 
connecting  that  midside  point  and  the 
other  midside  or  comer  point 

Module  IFF 


PLBAR 

Matrix 

A  partition  of  matrix  PA  (see  PG). 
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PLIST 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes 


Relation 

Contains  the  property  types  and  identification  nTimbers  associated  with  a  design 
variable. 


Created  By:  Module  IFP 

Notes: 

1.  The  PTYPE  is  the  name  of  the  relation  in  which  the  PID  associated  with  the 
design  variable  is  found. 

2.  This  relation  contains  one  tuple  for  each  PID  associated  with  each  PTYPE 
listed  in  each  unique  LINKID. 

3.  Allowable  PTYPE  entries  are: 

PROD  PCOMP,  PCOMPl,  PCOMP2 

PSHEAR  PMASS 

PQDMEM  PSHELL 

PTRMEM  PELAS 

PBAR 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


PLISTM 


Relation 

Contains  the  property  types  and  identification  numbers  associated  with  a  design 
variable. 


NAME 

TYPE/KEY 

DESCRIPTION 

LINKID 

Integer  >  0,  key 

Design  variable  identification 

PTYPE 

Tfext  (8) 

Property  relation  identifier 

PIDl 

Integer  >  0 

Property  identification 

DVSYMBL 

Tfext(8) 

Designed  dimension  symbol 

Module  IFF 


1. 

2. 

3. 


4. 


The  PTYPE  is  the  name  of  the  relation  in  which  the  FID  associated  with  the 
design  variable  is  found. 

This  relation  contains  one  tuple  for  each  FID  associated  with  each  FTYFE 
fisted  in  each  unique  LINKID. 

Allowable  FTYFE  entries  are: 

FROD  FCOMF,  FCOMFl,  FCOMF2 

FSHEAR  FMASS 

FQDMEM  FSHELL 

FTRMEM  FELAS 

FBAR 

Allowable  DVSYMBL  are: 


-  Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9,  DIO  for  BAR  element 
cross  section  dimensions; 

A  for  element  cross  section  area; 

T  for  element  thickness; 

M  for  element  mass; 

K  for  element  thickness. 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


PLOAD 

Relation 

Contains  the  load  information  defined  over  a  triangular  or  quadrilateral  region  as 
input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

SCALE 

Real 

Scale  factor 

GRIDl,  GRID2 

Integer  >  0 

Grid  points  defining  region  of  load 
application 

GRID3,  GRID4 

Integer  >  0 

Module  IFF 

1.  The  GRID4  entry  is  zero  if  a  triangular  region  is  defined. 


PLOAD2 

Relation 

Contains  the  uniform  static  pressure  load  information  defined  over  a  triangular  or 
quadrilateral  region  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

1  SETID 

Integer  >  0 

Set  identification  number 

1  SCALE 

Real 

Scale  factor 

EID 

Integer  >  0 

Element  identification  number 

Module  IFF 
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Entity: 

Entity  TVpe: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  TVpe: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


PLOAD4 

Relation 

Contains  the  load  information  defined  over  a  triangular  or  quadrilateral  region  as 
input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

EIDl 

Integer  >  0 

Element  identification  nmnber 

PI 

Real 

Pressure  at  Grid  point  1 

P2 

Real 

Pressure  at  Grid  point  2 

P3 

Real 

Fressure  at  Grid  point  3 

P4 

Real 

Fressure  at  Grid  point  4 

THRU 

'Itext(4) 

"THRU"  string  for  range  definition  of 
element  IDs 

EID2 

Integer  >  0 

The  last  element  identification  number 
in  a  range  definition 

CID 

Integer  >  0 

Coordinate  system  identification 
number 

VI 

Real 

Vector  components  in  system  CID  that 
defines  the  direction  of  the  GRID  point 
loads  generated  by  the  pressure 

V2 

V3 

Module  IFF 

PLYLIST 

Relation 

Contains  a  list  of  composite  layers  as  input  in  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0 

Set  identification  number  | 

PLY 

Integer  >  0 

Fly  number  j 

Module  IFF 


1.  This  relation  contains  one  tuple  for  each  ply  in  each  set. 
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Entity; 

Entity  Type: 
Description: 

Relation  Attributes : 


Created  By: 

Entity: 

Entity  Type; 
Description: 

Matrix  Form; 

Created  By: 
Notes; 


PNASS 

Relation 

Contains  the  mass  value  of  a  scalar  mass  element  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0,  key 

Property  identification  number 

MASS 

Real 

Mass  value 

TMIN 

Real  >  0.0 

Minimum  mass  value  for  design 

Module  IFF 

PMAXT 

Matrix 

Contains  the  maximum  thickness  design  variable  based  on  the  user’s  defined 
maximum  (laminate)  thickness. 

[t]  =  [PMAXT] ’^[v]  +  [VFIXD] 

A  variable-sized  single  precision  matrix  having  one  coliunn  for  each  shape  function 
designed  laminate  or  element  and  one  row  for  each  global  design  variable.  The  terms 
in  PMAXT  are  the  sum  of  the  PTRANS  columns  associated  with  one  laminate  (if 
composite). 

Module  MAKEST 

1.  If  a  layered  composite  has  some  undesigned  laminae,  the  VFIXD  entity  con¬ 
tains  the  terms  needed  to  calculate  the  fixed  contribution. 

2.  If  no  shape  function  linking  is  used,  this  matrix  will  have  no  columns. 
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Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 

Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 


PMINT 

Matrix 

Contains  the  minimum  thickness  variable  linking  terms  based  on  the  user’s  defined 
minimum  (laminate)  thickness. 

[t]  =  [PMINT]  ^[v] 

A  variable-size  single  precision  matrix  that  has  one  column  for  each  element 
designed  by  shape  function  linking  and  one  row  for  each  global  design  variable.  The 
terms  in  PMINT  are  the  PTRANS  column  for  the  shape  function  designed  element 
divided  by  the  user  input  minimum  (laminate)  thickness. 

Module  MAKEST 

1.  If  no  shape  function  linking  is  used,  this  matrix  will  have  no  columns. 

PN 

Matrix 

External  loads  applied  in  the  n-set  derived  from  PG  (see  PG). 

PNSF 

Subscripted  Matrix 

Contains  the  partitioning  vector  to  partition  the  independent  degrees  of  freedom 
(n-set)  into  the  dependent  single  point  constraint  set  (s-set)  and  the  free  degrees  of 
freedom  (f-set). 

A  variable-sized  single  precision  column  vector  containing  one  row  for  each  inde¬ 
pendent  degree  of  freedom.  Degrees  of  freedom  in  the  s-set  are  denoted  by  real  0.0 
and  those  in  the  f-set  by  real  1.0. 

Module  MKUSET 

PO 

Matrix 

A  partition  of  the  PF  matrix  (see  PG). 
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Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 
Entity  Type: 
Description: 


POARO 

Subscripted  Matrix 

Matrix  of  aerodynamic  “unit”  loads  applied  to  omitted  degrees  of  freedom. 

Real  rectangular  matrix  with  one  row  for  each  o-set  degree  of  freedom  and  the  same 
number  of  columns  as  the  AIRFRC  matrix. 

MAPOL 

1.  The  Matrix  may  be  required  in  the  static  aeroelastic  sensitivity  analysis  and 
is  therefore  subscripted  by  the  boundary  condition. 

PQDMEMl 

Relation 

Contains  the  properties  of  the  isoparametric  quadrilateral  membrane  element  as 
input  from  the  Bulk  Data  fide. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0,  key 

Property  identification  nxunber 

MIDI 

Integer  >  0 

Material  identification  number 

THICK 

Real>  0.0 

Element  thickness 

NSM 

Real  >  0 

Element  nonstructural  mass 

TMIN 

Real  >  0 

Minimum  thickness  for  design 

Module  IFF 

PR 

Matrix 

A  partition  of  the  PA  matrix  (see  PG). 


Entity: 

Entity  T^e: 
Description: 

Entity  Structure: 

Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


PRAS 

Unstructured 

Identifies  active  user  fimction  constraints  required  responses  for  the  current  bound¬ 
ary  condition. 

A  single  record  of  integers  whose  length  is  equal  to  the  number  of  responses  required 
by  active  user  function  constraints  in  the  current  boimdary  condition. 

Module  ABOUND 

There  is  one  integer  for  each  active  constraint.  The  integer  is  set  to  the  subcase 
number  of  the  constraint. 

PROD 

Relation 

Contains  the  property  data  for  ROD  elements  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

PID 

Integer  >  0,  key 

Property  identification  number 

MIDI 

Integer  >  0 

Material  identification  number  of  a  MATl 
tuple 

AREA 

Real  >  0.0 

Element  cross  sectional  area 

TORSION 

Real  >  0.0 

Torsional  constant 

STRSCOEF 

Real 

Stress  recovery  coefficient 

NSM 

Real  >  0.0 

Element  nonstructural  mass 

TMIN 

Real  >  0.0 

Minimum  cross-sectional  area  for  design 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


PS 

Matrix 

A  partition  of  the  PN  matrix  (see  PG). 

PSHEAR 

Relation 

Contains  the  property  data  for  the  shear  panel  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0,  key 

Property  identification  number 

MIDI 

Integer  >  0 

Material  identification  number 

THICK 

Real  >  0 

Element  thickness 

NSM 

Real  >  0.0 

Element  nonstructural  mass 

TMIN 

Real  >  0.0 

Minimum  thickness  for  design 

Module  IFP 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


PSHELL 

Relation 

Contains  the  membrane,  bending,  shear  and  coupling  properties  of  thin  two-dimen¬ 
sional  elements  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0,  key 

Property  identification  number 

MIDI 

Integer  >  0 

Membrane  material  id 

THICK 

Real  >  0 

Element  default  thickness 

MID2 

Integer  >  0 

Bending  material  id 

BENDSTIF 

Real 

Bending  stiffiiess  parameter 

MID3 

Integer  >  0 

Transverse  shear  material  id 

TRNSVRS 

Real 

Transverse  shear  thickness  divided  by  the 
membrane  thickness 

NSM 

Real  >0.0 

Element  nonstructural  mass 

FZl,  FZ2 

Real 

Fiber  distances  for  stress  computation 

MID4 

Real  >  0 

Membrane-bending  coupling  material 
identification 

CID2 

Integer 

Material  coordinate  system  identification 
number 

THETAM 

Real 

Material  orientation  angle 

CIDS 

Integer 

Stress  recovery  coordinate  system 

THETAS 

Real 

Stress  recovery  orientation  angle 

OFFSTl 

Integer 

Offset  of  the  mid  plane  from  the  plane  of 
the  grid  points 

TMIN 

Real  >  0.0 

Minimum  thickness  for  design 

Module  IFF 
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Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 

Entity: 

Entity  lype: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


PT6L0AD 

Matrix 

Applied  loads  matrix  on  the  physical  degrees  of  freedom  for  the  time  dependent  loads 
in  the  current  boundary  condition. 

Real  rectangular  matrix  with  one  row  for  each  physical  degree  of  freedom  and  one 
column  for  each  time  step  in  each  transient  analysis  in  the  current  coundary 
condition. 

Module  DYNLOAD 

1.  This  matrix  is  formed  only  if  the  LOAD  print  request  for  the  transient  disci¬ 
pline  is  set  for  the  current  boundary  condition. 

PTRANS 

Matrix 

Contains  the  linking  information  for  design  variables  if  the  model  has  design 
variables  defined. 

[t]  =  [PTRANSl'^tv] 

A  variable-sized  single  precision  matrix  having  one  column  for  each  local  design 
variable  and  one  row  for  each  global  design  variable. 

Module  MAKEST 

1.  This  matrix  is  empty  if  the  model  contains  no  design  variables. 

2.  A  column  of  PTRANS  is  the  sensitivity  of  the  local  variable  to  the  global  vari¬ 
able. 

PTRMEM 

Relation 

Contains  the  property  data  for  the  constant  strain  triangle  as  input  from  the  Bulk 
Data  file. 


1  NAME 

TYPE/KEY 

DESCRIPTION 

PID 

Integer  >  0,  key 

Property  identification  number 

MIDI 

Integer  >  0 

Material  identification  number  of  MATl  or 
MAT2  tuple  j 

THICK 

Real  >  0.0 

Element  thickness 

NSM 

Real  >  0.0 

Element  nonstructural  mass  I 

TMIN 

Real  >  0.0 

Minimum  thickness  for  design  | 

Module  IFF 
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Entity: 

PI 

Entity  lype: 

Matrix 

Description: 

Applied  loads  matrix  created  when  there  are  unrestrained  structural  degrees  of 
freedom. 

Matrix  Form: 

Real,  rectangular  matrix  with  one  row  for  each  a-set  degree  of  freedom  and  one 
column  for  each  subcase  or  column  in  the  PAF  matrix,  depending  on  whether  a  static 
analysis  or  a  static  aeroelastic  analysis  is  being  performed. 

Created  By: 

MAPOL 

Entity: 

P2 

Entity  TVpe: 

Matrix 

Description: 

Applied  loads  matrix  created  when  there  are  unrestrained  structural  degrees  of 
freedom. 

Matrix  Form: 

Real,  rectangular  matrix  with  one  row  for  each  r-set  degree  of  freedom  and  one 
column  for  each  subcase  or  column  in  the  PAF  matrix,  depending  on  whether  a  static 
analysis  or  a  static  aeroelastic  analysis  is  being  performed. 

Created  By: 

MAPOL 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


QDMMIEST 

Relation 

Contains  the  element  summary  data  for  the  isoparametric  quadrilateral  membrane 
element. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

PID 

Integer  >  0 

Element  property  identification  number 

PTYPE 

Text  (8) 

Element  property  t37pe 

LAYKMUM 

Integer  >  0 

Composite  layer  number 

SILl 

Integer  >  0 

Internal  grid  point  id 

SIL2 

Integer  >  0 

SIL3 

Integer  >  0 

SIL4 

Integer  >  0 

CID 

Integer  >  0 

Coordinate  system  defining  material  axis 

THETA 

Real 

Material  orientation  angle  for  anisotropic 
material  behavior 

MIDI 

Integer  >  0 

Material  id  of  MATl  or  MAT2  tuple 

THICK 

Real  >  0.0 

Element  thickness 

NSM 

Real  >  0.0 

Element  nonstructural  mass 

COORDl 

Integer  >  0 

External  coordinate  system  id  for  1 

displacements  at  SILl  | 

1  XI,  Yl,  Z1 

Real 

Basic  coordinates  of  SILl  1 

COORD2 

Integer  >  0 

External  coordinate  system  id  for  1 

displacements  at  SIL2 

X2,  Y2,  Z2 

Real 

Basic  coordinates  of  SIL2 

COORD3 

Integer  >  0 

External  coordinate  system  id  for  1 

displacements  at  SIL3  | 

X3  ,  Y3 ,  Z3 

Real 

Basic  coordinates  of  SIL3 

COORD4 

Integer  >  0 

External  coordinate  system  id  for 
displacements  at  SIL4 

X4,  Y4,  Z4 

Real 

Basic  coordinates  of  SIL4 

SCON 

Integer 

Stress  constraint  flag  | 

DESIGN 

Integer 

Design  flag  1 
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NAME 

TYPE/KEY 

DESCRIPTION 

STHRM 

Real  Array 
(3) 

Thermal  stress  terms  for  the  constrained 
element 

STHRMA 

Real  Array 
(3) 

Thermal  strain  terms  for  the  constrained 
element 

TREFTP 

Integer  >  0 

Pointer  to  the  TREF  entity  for  thermal 
loads/stress  evaluation  of  the  designed  element 

NLFLAG 

Integer  >  0 

Nonlinear  design  variable  flag 
=  0  linear 
=  1  NSM^O 

ELRSPREQ 

Integer 

User  function  element  response  flag 
=  1  Element  response  required 
=  0  Element  response  not  required 

Created  By:  Module  MAKEST 

Notes: 

1.  This  relation  is  btailt  from  the  CQDMEMl,  associated  P-type  and  the  basic 
grid  point  data.  It  contains  one  tuple  for  each  quadrilateral  membrane  ele¬ 
ment  in  the  problem. 

2.  A  nonzero  SCON  flag  denotes  that  the  element  is  affected  by  a  stress  con¬ 
straint. 

3.  A  nonzero  DESIGN  flag  denotes  that  the  element  is  affected  by  a  design 
variable. 

4.  LAYRNUM  is  zero  for  noncomposite  elements. 


Entity: 

Entity  T^pe: 
Description: 

Matrix  Form: 


QEE 

Matrix 

A  partition  of  the  GENQ  matrix  that  contains  only  elastic  degrees  of  freedom.  Used 
in  the  nuclear  blast  response  analysis. 

Real  square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number  of 
elastic  modes  retained  for  the  blast  analysis. 


Created  By: 


MAPOL 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 
Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


QHHL 

Matrix 

Matrix  list  of  generalized  vmsteady  aerodynamic  coefficients. 

Complex  rectangular  matrix  with  one  row  for  each  retained  mode  shape  and  with 
the  number  of  columns  equal  to  the  product  of  the  number  of  retained  mode  shapes 
and  the  number  of  M-k  pairs  at  which  aerodynamics  are  required. 

Module  QHHLGEN 

1.  The  matrix  may  he  required  in  the  flutter  sensitivity  analysis  and  is  there¬ 
fore  subscripted  by  bormdary  condition. 

QHJL 

Matrix 

Generalized  aerodynamic  data  for  the  gust  loads  determination. 

A  variable-sized  matrix  list.  Each  Mach  number  and  reduced  frequency  required  in 
the  gust  analysis  creates  a  matrix  with  one  row  for  each  retained  mode  panel  and 
one  volume  for  each  aerodynamic  panel. 

QHHLGEN 

1.  See  QeJJKL 

2.  The  order  of  the  matrices  in  the  list  is  the  order  of  M-k  pairs  in  UNMK. 

QJJL 

Matrix 

Matrix  list  of  unsteady  aerodynamic  coefficients. 

Complex  rectangular  matrix  with  one  row  for  each  aerodynamic  panel  and  with  the 
number  of  columns  equal  to  the  product  of  the  number  of  aerodynamic  panels  and 
the  number  of  M-k  pairs  at  which  aerodynamics  are  required. 

Module  AMP 

1.  This  matrix  list  is  generated  only  if  there  is  a  requirement  for  nuclear  blast 
analysis. 

2.  The  matrix  components  in  QJJL  are  the  inverse  of  the  transpose  of  the  ma¬ 
trix  components  of  matrix  AJJTL  associated  with  BLAST  analyses. 
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Entity: 
Entity  lype: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


QKJL 

Matrix 

Aerod3niamic  interpolation  list  containing  data  required  for  gust  analysis. 

A  variable-sized  matrix  list.  There  is  an  nk  by  nj  matrix  for  each  Mach  number  and 
reduced  frequency  required  in  the  gust  analysis. 

Module  AMP 

1.  The  order  of  the  matrices  in  the  hst  is  the  order  of  M-k  pairs  in  UNMK. 

2.  One  matrix  QKJ  is  generated  for  each  M-k  pair  associated  with  gust  analyses. 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 


Created  By: 


QKKL 

Matrix 

Matrix  list  of  unsteady  aerodynamic  coefiBcients. 

Complex  rectangular  matrix  with  one  row  for  each  aerodynamic  degree  of  freedom 
and  with  the  number  of  columns  equal  to  the  product  of  the  number  of  aerodynamic 
degrees  of  freedom  and  the  number  of  M-k  pairs  at  which  aerodjmamics  are 
required. 

Module  AMP 

1.  The  matrix  components  of  this  list  are  generated  from: 

[QKK]  =  [SJK]  [AJJT]  [  [DIJK]  +  ik[D2JK]  ] 

2.  One  matrix  QKK  is  generated  for  each  M-k  pair  associated  with  flutter  or 
gust  analyses. 

QRE 

Matrix 

A  partition  of  the  GENQ  matrix. 

Real  rectangular  matrix  with  the  number  of  rows  equal  to  the  number  of  rigid  body 
modes  and  the  number  of  columns  equal  to  the  number  of  elastic  modes  retained  for 
the  blast  analysis. 

MAPOL 
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Entity; 
Entity  Type; 
Description; 
Matrix  Form: 

Created  By; 


QRR 

Matrix 

A  partition  of  the  GENQ  matrix. 

Real  square  matrix  with  the  number  of  rows  and  columns  equal  to  the  number  of 
rigid  body  modes  in  the  blast  analysis. 

MAPOL 


QUAD4EST 

Relation 

Contains  the  element  summary  data  for  the  quadrilateral  QUAD4  plate  element. 


Entity: 

Entity: 

Description: 
Relation  Attributes: 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

PID 

Integer  >  0 

Element  property  identification  number 

PTYPE 

Tfext  (8) 

Element  property  t3T)e 

LAYRNUM 

Integer  >  0 

Composite  layer  number 

SILl 

Integer  >  0 

Internal  grid  point  id  1 

SIL2 

Integer  >  0 

Internal  grid  point  id  2 

SIL3 

Integer  >  0 

Internal  grid  point  id  3 

SIL4 

Integer  >  0 

Internal  grid  point  id  4 

TRATIOl 

Real  >  0.0 

Ratio  of  membrane  thickness  to  element 
thickness  for  grid  1 

TRATI02 

Real  >  0.0 

Ratio  of  membrane  thickness  to  element 
thickness  for  grid  2 

TRATI03 

Real  >  0.0 

Ratio  of  membrane  thickness  to  element 
thickness  for  grid  3 

TRATI04 

Real  >  0.0 

Ratio  of  membrane  thickness  to  element 
thickness  for  grid  4 

CIDl 

Integer  >  0 

Coordinate  system  defining  material  axis 

THETAM 

Real 

Material  orientation  angle 

OFFSTO 

Real 

Initial  offset  of  the  element  reference  plane 
fi-om  the  plane  of  grid  points. 

MIDI 

j 

Integer  >  0 

Material  identification  number  for  membrane 

THICK 

Real  >  0.0 

Membrane  thickness 

MID2 

Integer  >  0 

Material  identification  number  for  bending 

BENDSTIF 

Real  >  0.0 

Bending  stiffness  parameter 

MID3 

Integer  >  0 

Material  identification  number  for  transverse 
shear  I 

TRNSVRS 

Real  >  0.0 

Transverse  shear  thickness  factor  1 

NSM 

Real  >  0.0 

nonstructural  man  I 

FZl 

Real  >  0.0 

Fiber  distance  for  stress  computation  1 

FZ2 

Real  >  0.0 

Fiber  distance  for  stress  computation  I 

MID4 

Integer  >  0 

Material  identification  number  for  membrane- 
bending  coupling 

CIDS 

Integer  >  0 

Coordinate  system  defining  stress  output 
coordinate  system 
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XI,  Yl,  Z1 


C00RD2 


X2,  Y2,  Z2 


Integer 


Real 


Integer  >  0 


Integer  >  0 


Integer  >  0 


Integer _ 


Integer 


ReaIArray(3) 

RealArray(3) 


ELTHKO 


Real  >  0.0 


Stress  output  orientation  angle _ _ 


External  coord  system  for  SILl _ _ 


Basic  coordinates  of  SILl _ 


External  coord  system  for  SIL2 


Basic  coordinates  of  SIL2 


External  coord  system  for  SIL3 


Basic  coordinates  of  SIL3 _ _ 


External  coord  system  for  SIL4 _ 


Basic  coordinates  of  SIL4  _ 


Stress  constraint  flag  _ 


Design  flag _ 


Thermal  stress  terms  for  the  constrained  element 
Thermal  strain  terms  for  the  constrained  element 


Pointer  to  the  TREE  entity  for  thermal 
loads/stress  evaluation  of  the  designed  element 


Nonlinear  design  variable  flag 
=  0  Linear  design  variable 
=  1  Nonzero,  nonstructural  mass  (NSM  ^  0) 
=  2  Nonlinear  design  stif&iess 
=  3  Nonlinear  design  stif&iess  and 
NSM  9^0 

=  4  Nonlinear  design  stiffiiess  and  design 
mass 

=  5  Nonlinear  design  stif&ess  and  mass  and 
NSM  0  _ 


Composite  element  type  flag 

=  0  Noncomposite  element 
(1  entry  for  layer  "0") 

=  1  Nondesigned  and  nonconstrained 

composite  element  (1  entry  for  layer  ”0" 
for  equiv.  single  layer) 

=  2  Nondesigned  and  constrained  composite 
element  (1  entry  for  layer  *'0”  for 
eqxiiv.  single  layer  and  nlayer  entries  at 
each  layer) 

=  3  Designed  membrane  composite  element 
entries  at  each  layer 

=  4  Designed  bending  composite  element 
(1st  entry  for  equiv.  single  layer  and 
entries  at  each  layer) _ _ 


Initial  user  input  membrane  thickness 
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Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


NAME 

TYPE/KEY 

DESCRIPTION 

ELRSPREQ 

Integer 

User  function  element  response  flag 
=  1  Element  response  required 
=  0  Element  response  not  required 

LAYERPOS 

Integer 

This  layer’s  position  among  all  composite  layers 

Module  MAKEST 

1.  This  relation  is  built  from  the  CQUAD4,  associated  P-type  and  the  basic  grid 
point  data.  It  contains  one  tuple  for  each  isoparametric  QUAD4  element  in 
the  problem. 

2.  The  number  of  EST  entries  for  a  composite  element  could  be  equal  to  the 
number  of  layers,  or  to  the  number  of  layers  +  one,  depending  on  the  compos¬ 
ite  type.  (See  preceeding  CMPFLG  description) 

RANDPS 

Relation 

Contains  the  definition  of  load  set  power  spectral  density  factors  for  use  in  Random 

analysis  having  the  fi-equency  dependent  form. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Random  analysis  set  identification  number 

EXCITID 

Integer  >  0 

Subcase  identification  number  of  excited 
load  set 

APPLYID 

Integer  >  0 

Subcase  identification  number  of  applied 
load  set 

X,  Y 

Real 

Components  of  complex  number 

TABROTID 

Integer  >  0 

Identification  number  of  a  TABRNDi  entry 

Module  IFP 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


REAR 

Relation 

Contains  the  definition  of  a  rigid  bar  element  with  six  degrees  of  freedom  at  each 
end. 


NAME 

TYPE/KEY 

DESCRIPTION  n 

SETID 

Integer  >  0 

MFC  identification  number 

EID 

Integer  >  0 

Rigid  bar  element  identification  number 

GA,GB 

Integer  >  0 

Grid  point  identification  numbers  of 
connection  points. 

CNA,CNB 

Integer 

Independent  DOF  in  the  global  coordinate 
system  for  the  elements  at  grid  point  GA 
and  GB. 

CMA,CMB 

Integer 

Dependent  DOF  in  the  global  coordinate 
system  assigned  by  the  element  at  grid 
point  GA  and  GB 

Module  IFF 


RBEl 

Relation 

Contains  the  definition  of  a  rigid  body  connected  to  an  arbitrary  number  of  grid 
points. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

MFC  identification  number 

EID 

Integer  >  0 

Rigid  body  element  identification  number 

GXI 

Integer  >  0 

Grid  point  identification  numbers  at  which 
dependent/independent  DOF  are  assigned 

CXI 

Integer  >  0 

Component  numbers  of 
dependent/independent  DOF  in  the  global  1 
coordinate  system  at  grid  points  GXi  1 

UMFLAG 

Text  (4) 

Character  string  indicating  the  start  of  the  I 
list  of  dependent  degrees-of-fireedom  j 

Created  By: 


Module  IFF 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


RBE2 

Relation 

Contains  the  definition  of  a  rigid  body  whose  independent  degrees-of-freedom  are 
specified  at  a  single  grid  point  and  whose  dependent  degrees-of-freedom  are  speci¬ 
fied  at  an  arbitrary  number  of  grid  points. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

MPC  identification  number 

EID 

Integer  >  0 

Rigid  body  element  identification  number 

GN 

Integer  >  0 

Grid  point  identification  number  at  which 
all  six  independent  DOF  are  assigned 

CM 

Integer 

Component  numbers  of  dependent  degrees- 
of-freedom  in  the  global  coordinate  system 
assigned  by  the  element  at  grid  points  GMi 

GMI 

Integer  >  0 

Grid  point  identification  number  at  which 
dependent  DOF  are  assigned 

Module  IFF 

RBE3 

Relation 

Contains  the  definition  of  the  motion  of  a  reference  grid  point  as  the  weighted 
average  of  motions  at  a  set  of  other  grid  points. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

MPC  identification  number 

EID 

Integer  >  0 

Rigid  body  element  identification  nximber 

REFGRID 

Integer  >  0 

Reference  grid  point  identification  number 

REFC 

Integer 

Component  nmnbers  of  DOF  in  the  global 
coordinate  system  that  will  be  computed  at 
REFGRID 

QI 

Integer 

Integer  field  of  either  grid  point  ID  or 
component  number 

QR 

Real 

Real  field  of  weighting  factor 

UMFLAG 

Ifext  (4) 

Character  string  indicating  the  start  of  the 
list  of  dependent  DOF  | 

Module  IFF 


740 


Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


RGCFRESP 

Relation 

Contains  the  user  function  requested  steady  aeroelastic  rigid  stability  coefficient 
response  values. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value 

Module  SAERO 
RHS 

Subscripted  Matrix 

Amatrix  used  in  the  analysis  of  free-free  structures  that  corresponds  to  load  vectors 
apphed  to  the  supported  degrees  of  freedom. 

The  number  of  rows  is  equal  to  the  number  of  degrees  of  freedom  in  the  r-set  while 
the  number  of  columns  varies  by  the  type  of  analysis  being  performed. 

MAPOL 

1.  For  an  inertia  rehef  analysis,  RHS  is  equal  to  PR  plus  the  transpose  of  D 
times  PLBAR. 

2.  For  a  static  aeroelastic  analysis,  RHS  is  equal  to  P2  minus  K21  times  PAR. 

3.  Since  RHS  may  be  needed  in  the  sensitivity  analysis,  it  is  subscripted  by 
boundary  condition  number. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


RLOADl 

Relation 

Contains  information  on  frequency  dependent  loads  as  defined  in  the  RLOADl  bulk 
data  entry. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0 

Set  identification  number 

ILAG 

Integer 

Identification  number  for  DLAGS 

ITC 

Integer 

Identification  number  for  TABLEDi(C) 

ITD 

Integer 

Identification  number  for  TABLEDi(D)  | 

Module  IFF 


1.  The  relation  is  used  in  FRLGA  to  generate  dynamic  loads. 

RLOAD2 

Relation 

Contains  information  to  define  frequency  dependent  dynamic  loads  in  a  form 
specified  in  the  RLOAD2  bulk  data  entry. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0 

Set  identification  number 

1  ILAG 

Integer 

Identification  number  for  DLAGS 

I 

Integer 

Identification  number  for  TABLEDi(B) 

TP 

Integer 

Identification  number  for  TABLEDi(F) 

Module  IFF 
Notes: 

1.  The  relation  is  used  in  FRLGA  to  generate  dynamic  loads. 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


RODEST 

Relation 

Contains  the  element  summary  data  for  the  ROD  element. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

PID 

Integer  >  0 

Element  property  identification  number 

SILl 

Integer  >  0 

Internal  id  of  grid  at  end  A 

1  SIL2 

Integer  >  0 

Internal  id  of  grid  at  end  B 

— 

MIDI 

Integer  >  0 

Material  id  of  a  MATl  tuple 

AREA 

Real  >  0.0 

Element  cross-sectional  area 

1  ^ 

Real  >  0.0 

Tbrsional  constant 

1  ^ 

Real 

Stress  recovery  coefficient 

1  NSM 

Real  >  0.0 

Element  nonstructural  mass 

- _ _ _ 

COORDl 

Integer  >  0 

External  coordinate  system  id  for 
displacements  at  end  A 

XI,  Yl,  Z1 

Real 

Basic  coordinates  at  end  A 

COORD2 

Integer  >  0 

External  coordinate  system  id  for 
displacements  at  end  B 

X2,  Y2,  Z2 

Real 

Basic  coordinates  at  end  B 

SCON 

Integer 

Stress  constraint  flag 

DESIGN 

Integer 

Design  flag 

STHRM 

Real 

Thermal  stress  term  for  the  constrained 
element 

STHRMA 

Real 

Thermal  strain  term  for  the  constrained 
element  1 

TREFPT 

Integer  >  0 

Pointer  to  TREE  entity  for  thermal  stress 
evaluation  and  thermal  loads  evaluation  | 

NLFLAG 

Integer  >  0 

Nonlinear  design  variable  flag 
=  0  linear  design  variable 
=  1  NSM^tO 

1  ELRSPREQ 

Integer 

User  function  element  response  flag 
=  1  Element  response  required 
=  0  Element  response  not  required 

Module  MAKEST 
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Notes: 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


1.  This  relation  is  built  from  the  CONROD,  CROD,  PROD  and  basic  grid  point 
relations.  It  contains  one  tuple  for  each  ROD  element  in  the  problem. 

2.  A  nonzero  SCON  flag  denotes  that  the  element  is  affected  by  a  stress  con¬ 
straint. 

3.  A  nonzero  DESIGN  flag  denotes  that  the  element  is  affected  by  a  design 
variable. 

RROD 

Relation 

Contains  the  definition  of  a  pin-ended  rod  that  is  rigid  in  extension. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

MPC  identification  number 

EID 

Integer  >  0 

Rigid  rod  element  identification  number 

GA,GB 

Integer  >  0 

Grid  point  identification  numbers  of 
connection  points. 

CMA,CMB 

:  Integer 

Component  number  of  one  dependent  DOF 
in  the  global  coordinate  system  assigned  by 
the  element  at  either  grid  point  GA  or  GB 

Module  IFP 

R21 

Subscripted  Matrix 

Intermediate  matrix  formed  in  the  solution  of  structures  that  contain  unrestrained 
degrees  of  freedom. 

Real  rectangular  matrix  with  one  row  for  each  r-set  degree  of  freedom  and  one 
column  for  each  a-set  degree  of  freedom. 

MAPOL 

1.  R21  is  the  transpose  of  IFR. 
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Entity; 

Entity  lype: 
Description: 

Matrix  Form: 
Created  By: 
Notes: 


Entity: 
Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 
Entity  Type; 
Description: 
Matrix  Form: 
Created  By: 
Notes: 


R22 

Matrix 

Intermediate  matrix  formed  in  the  solution  of  structures  that  contain  unrestrained 
degrees  of  freedom. 

Real  square  matrix  with  one  row  and  column  for  each  r-set  degree  of  freedom. 
MAPOL 

1.  R22  is  created  from: 

[R22]  =  [D]’^[MLR]  +  [MRRBAR] 

R31 

Subscripted  Matrix 

Intermediate  matrix  formed  in  the  solution  of  static  aeroelastic  response. 

Real  rectangular  matrix  with  one  row  and  column  for  each  r-set  degree  of  freedom 
and  one  colizmn  for  each  1-set  degree  of  freedom. 

MAPOL 

1.  R31  is  only  computed  for  the  steady  aeroelastic  analysis. 

2.  R31  is  created  from: 

[R31]  =  [D1^[KALL]  +  [KARL] 

R32 

Subscripted  Matrix 

Intermediate  matrix  formed  in  the  solution  of  static  aeroelastic  response. 

Real  square  matrix  with  one  row  and  column  for  each  r-set  degree  of  freedom. 
MAPOL 

1.  R32  is  only  computed  for  the  steady  aeroelastic  analysis. 

1.  R32  is  created  from: 

[R32]  =  [D]'^[KALR1  +  [KARR] 
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Entity: 

Entity  IVpe: 
Description: 

Relation  Attributes : 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


SAVE 

Relation 

Contains  a  list  of  data  base  entities  whose  contents  are  to  be  saved  rather  then 
purged  through  the  UTPURG  utility. 


NAME 

TYPE/KEY 

DESCRIPTION 

ENTNAM 

Ifext  (8) 

The  name  of  a  database  entity. 

Module  IFF 


1.  An  entity  named  in  this  relation  will  not  have  its  contents  purged  by  the  UT¬ 
PURG  utihty. 

SEQGP 

Relation 

Contains  the  user  selected  resequencing  requests  for  the  grid  and  scalar  points  of 
the  structural  modes. 


NAME 

TYPE/KEY 

DESCRIPTION 

EXTID 

Integer  >  0 

Grid  point  identification  number 

SEQNUM 

Text  (8) 

Sequenced  identification  number  (see  beolw) 

Module  IFP 

1.  EXTID  is  any  grid  or  scalar  point  identification  number  which  is  to  be  reiden¬ 
tified  for  sequencing  purposes.  The  sequence  number  is  a  special  number 
which  may  have  any  of  the  following  forms  where  X  is  a  decimal  integer  digit 
—  XXXX.X.X.X,  XXXX.X.X,  XXXX.X,  or  XXXX  where  any  of  the  leading  X’s 
may  be  omitted.  This  string  contains  no  imbedded  blanks.  The  leading  charac¬ 
ter  will  not  be  a  decimal  point. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


SETl 

Relation 

Contains  a  list  of  structural  grid  points  to  be  used  in  splining  loads  from  aerody¬ 
namic  points  to  structural  points  and  modes  to  be  omitted  from  flutter  analyses. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

GRIDI 

Integer  >  0 

Structural  grid  point  id 

Module  IFF 


1.  This  relation  contains  one  tuple  for  each  grid  point  in  each  set. 


SET2 

Relation 

Contains  the  definition  of  a  set  of  structural  grid  points  in  terms  of  aerodynamic 
elements.  The  set  will  be  used  to  spline  aero  loads  to  the  structure. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

SETID 

Integer  >  0 

Set  identification  number 

SPl 

Real 

Lower  spanwise  division 

SP2 

Real 

Upper  spanwise  division 

CHI 

Real 

Lower  chordwise  division 

CH2 

Real 

Upper  chordwise  division 

ZMAX 

Real 

Z-coordinate  of  upper  surface 

ZMIN 

Real 

Z-coordinate  of  lower  surface 

Module  IFF 


1.  Tuples  of  this  relation  are  referenced  by  the  GRDSETID  attribute  of  the 
SFLINEl  and  SFLINE2  relations. 


Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


SHAPE 

Relation 

Contains  the  element  identification  numbers  and  weighting  factors  specified  on  the 
SHAPE  Bulk  Data  entry. 


NAME 

TYPE/KEY 

DESCRIPTION 

SHAPEID 

Integer 

Shape  identification  number 

ETYPEl 

Tfext  (8) 

Element  type 

EIDl 

Integer 

Element  identification  number 

PREF 

Real 

Design  variable  linking  factor 

Module  IFP 


1.  Allowable  ETYPEl  entries  are: 

-  CROD,  CONROD 

-  CSHEAR 

-  CQDMEMl 

-  CQUAD4 

-  CTRIA3 

-  CTRMEM 


CMASSl,  CMASS2 

CBAR 

CONM2 

CELASl,  CELAS2 
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Entity: 


Entity  T^e: 


Description: 


Relation  Attributes: 


SHAPEM 

Relation 

Contains  the  element  identification  numbers  and  weighting  factors  specified  on  the 
SHAPEM  Bulk  Data  entry. 


NAME 

TYPE/KEY 

DESCRIPTION 

SHAPEID 

Integer 

Shape  identification  number 

ETYPEl 

Tfext  (8) 

Element  type 

EIDl 

Integer 

Element  identification  number 

DVSYMBL 

TBxt(8) 

Designed  dimension  symbol 

PREF 

Real 

Design  variable  linking  factor 

Created  By: 
Notes: 


Module  IFF 


1. 


2. 


Allowable  ETYPEl  entries  are: 

-  CROD.CONROD 

-  CSHEAR 

-  CQDMEMl 

-  CQUAD4 

-  CTRIA3 

-  CTRMEM 


-  CMASSl,  CMASS2 

-  CBAR 

-  CONM2 

-  CELASl,  CELAS2 


Allowable  DVSYMBL  are: 

-  Dl,  D2,  D3,  D4,  D5,  D6,  D7,  D8,  D9,  DIO  for  BAR  element 
cross  section  dimensions; 

A  for  element  cross  section  area; 

T  for  element  thickness; 

M  for  element  mass; 

K  for  element  thickness . 
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Entity: 

Entity  IVpe: 
Description: 
Relation  Attributes: 


Created  By: 


SHEAREST 

Relation 

Contains  the  element  summary  data  for  the  shear  panel. 


NAME 

TYPE/KEY 

DESCRIPTION 

. 

EID 

Integer  >  0,  key 

Element  identification  number 

PID 

Integer  >  0 

Element  property  identification  number 

SILl 

Integer  >  0 

Internal  grid  point  id 

SIL2 

Integer  >  0 

SIL3 

Integer  >  0 

SIL4 

Integer  >  0 

MIDI 

Integer  >  0 

Material  id  of  a  MATl  tuple 

THICK 

Real  >  0.0 

Element  thickness 

NSM 

Real  >  0.0 

Element  nonstructural  mass 

COORDl 

Integer  >  0 

External  coordinate  system  id  for 
displacements  at  SILl 

XI,  Yl,  Z1 

Real 

Basic  coordinates  of  SILl 

COORD2 

Integer  >0 

External  coordinate  system  id  for 
displacements  at  SIL2 

X2,  Y2,  Z2 

Real 

Basic  coordinates  of  SIL2 

COORD3 

Integer  >  0 

External  coordinate  system  id  for 
displacements  at  SIL3 

X3,  Y3,  Z3 

Real 

Basic  coordinates  of  SIL3 

COORD4 

Integer  >  0 

External  coordinate  system  id  for 
displacements  at  SIL4 

X4,  Y4,  Z4 

Real 

Basic  coordinates  of  SIL4 

SCON 

Integer 

Stress  constrain  flag 

DESIGN 

Integer 

Design  flag 

NLFLAG 

Integer  >  0 

Nonlinear  design  variable  flag 
=  0  linear  design  variable 
=  1  NSM^O 

ELRSPREQ 

Integer 

User  function  element  response  flag 
=  1  Element  response  required 
=  0  Element  response  not  required 

Module  MAKEST 
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Notes: 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 
Entity  Type: 
Description: 

Matrix  Form 

Created  By: 


1.  This  relation  is  built  from  the  CSHEAR,  associated  P-type  and  the  basic  grid 
point  relations.  It  contains  one  tuple  for  each  shear  panel  in  the  problem. 

2.  A  nonzero  SCON  flag  denotes  that  the  element  is  affected  by  a  stress  con¬ 
straint. 

3.  A  nonzero  DESIGN  flag  denotes  that  the  element  is  affected  by  a  design  vari¬ 
able. 


SHPGEN 

Relation 

Contains  the  design  variable  identification  numbers,  the  list  of  associated  elements 
and  the  shape  to  be  generated  by  the  Shape  Generation  Utility  as  specified  on  the 
SHPGEN  Bulk  Data  entry. 


NAME 

TYPE/KEY 

DESCRIPTION 

SHAPEID 

Integer  >  0 

Design  variable  shape  function  identification 
number 

ELMLID 

Integer  >  0 

ELEMLIST  set  identification  number  for 
associated  elements 

SHAPE 

Tfext(4) 

Desired  shape 

XO 

Real 

X-coordinate  in  the  basic  system  of  the  new 
origin  for  shape  generation 

YO 

Real 

Y-coordinate  in  the  basic  system  of  the  new 
origin  for  shape  generation 

1  zo 

Real 

Z-coordinate  in  the  basic  system  of  the  new  1 

origin  for  shape  generation  1 

Module  IFP 


SKJ 

Matrix 

Unsteady  aerodynamic  integration  matrix  hst  that  translates  pressures  into  forces 
and  moments. 

Real  rectangular  matrix  with  one  row  for  each  aerodynamic  degree  of  freedom  and 
one  column  for  each  aerodynamic  panel  for  each  M-k  pair. 

Module  UNSTEADY 


Entity: 

Entity  lype: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


SLPMOD 

Matrix 

Intermediate  matrix  in  the  nuclear  blast  response  calculation  to  transform  elastic 
eigenvectors  into  slopes  at  aerodynamic  panel  control  points. 

Real  rectangular  matrix  with  one  row  for  each  aerodynamic  panel  and  one  column 
for  each  elastic  eigenvector. 

MAPOL 

SMAT 

Matrix 

Contains  the  linear  portion  of  the  sensitivity  of  the  stress  and  strain  in  the  element’s 
coordinate  system  to  the  global  displacements. 

A  variable-sized  double  precision  matrix  having  one  column  for  every  stress/strain 
term  in  each  linearly  designed  element  that  is  constrained  by  a  stress/strain 
constraint  tuple  or  its  stress/strain  responses  are  required  by  user  functions,  and 
one  row  for  every  structin-al  degree  of  freedom.  The  columns  are  stored  in  the  order 
the  elements  are  processed  in  EMG.  Relation  SMATCOL  has  matrix  column  infor¬ 
mation  for  each  related  elements. 

Module  EMG 

1.  This  matrix  is  not  built  if  no  linearly  designed  elements’  stresses  or  strains 
are  constrained. 

2.  SMAT  and  NLSMAT  are  used  by  SCEVAL  module  for  constraint  evaluation 
and  IMAKDFU  for  sensitivity  evaluation. 


Entity; 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 

Entity; 

Entity  Type; 
Description: 
Entity  Structure; 


Created  By; 


SMATCOL 

Relation 

Contains  the  matrix  [SMAT]  column  information  for  all  realted  elements. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

Text  (8) 

Element  type 

LAYERMJM 

Integer  >  0 

Composite  layer  number 

STRECOL 

Integer  >  0 

The  first  column  number  in  [SMAT]  for  this 
element/layer  stress 

NCOLSTRE 

Integer  >  0 

The  number  of  columns  in  [SMAT]  for  this 
element/layer  stress 

STRACOL 

Integer  >  0 

The  first  column  number  in  [SMAT]  for  this 
element/layer  strain 

NCOLSTRA 

Integer  >  0 

The  number  of  columns  in  [SMAT]  for  this 
element/layer  strain 

Module  EMG 


SMPLOD 

Unstructured 

Simple  load  vector  information. 

Record  1  contains  Ihree  integers  defining  the  number  of  (1)  simple  external  loads, 
NEXTLD,  (2)  gravity  loads,  NGRAV,  and  (3)  thermal  loads,  NTHERM,  followed  by 
a  list  of  load  identification  numbers  for  each  of  the  three  groups  in  sorted  order 
within  each  group. 

The  second  through  NEXTLD  +  1  records  contain  the  external  loads. 

Module  LODGEN 
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Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


SPC 

Relation 

Contains  the  definition  of  the  single  point  constraints  and  enforced  displacements 
as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

GRIDl 

Integer  >  0 

Grid  or  scalar  point  id 

COMFNTS 1 

Integer  >  0 

Components  of  GRIDl  that  are  constrained 

ENFDISP 

Real 

The  value  of  the  enforced  displacement  at  all 
coordinates  specified  by  COMPNTSl 

Module  IFF 

1.  This  relation  is  used  by  the  MKUSET  module  to  build  the  single-point  con¬ 
straint  set. 


SPCl 


Relation 

Contains  the  definition  of  the  single  point  constraints  as  input  from  the  Bulk  Data 


file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

COMFNTS 

Integer  >  0 

Components  to  be  constrained 

GRIDl 

Integer  >  0 

Grid  point  id  defining  the  constrained 
components  j 

Module  IFF 

1.  This  relation  is  used  by  the  MKUSET  module  to  build  the  single-point  con¬ 
straint  set. 

2.  This  relation  will  contain  one  tuple  for  each  grid  point  specified  in  each 
unique  set  of  COMFNTS;  for  example, 

COMFNTS  =  236,  grids  5,6,  8  and  9 

and 

COMFNTS  =  134,  grids  10,  20 
will  result  in  6  tuples. 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes : 


Created  By: 
Notes: 


SPCADD 

Relation 

Contains  the  definition  as  input  from  the  Bulk  Data  file  of  a  single-point  constraint 
sets  as  a  imion  of  SPC  and/or  of  SPCl  sets. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

— 

SPCSETID 

Integer  >  0 

Set  id  of  a  SPC  or  SPCl  tuple 

Module  IFP 

1.  This  relation  is  used  by  the  MKUSET  module  to  build  the  single-point  con¬ 
straint  set. 

SPLINEl 

Relation 

Contains  the  definition  of  surface  splines  used  for  interpolating  out-of-plane  motion 
in  aeroelastic  analysis. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

CP 

Integer  >  0 

Coordinate  system  defining  the  plane  of 
the  spline 

CAEROID 

Integer  >  0 

Aero  element  id 

BOXl 

Integer  >  0 

First  aero  box  to  use  the  spline  | 

BOX2 

Integer  >  0 

Last  aero  box  to  use  the  spline  I 

GRDSETID 

Integer  >  0 

Set  id  of  a  SETi  tuple  defining  the  I 

structiiral  grids  1 

FLEX 

Real 

Linear  attachment  flexibihty  | 

Module  IFP 


1.  Aerodynamic  boxes  are  numbered  sequentially  in  chordwise  strips. 
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Entity: 

Entity  TVpe: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  TVpe: 
Description: 

Relation  Attributes: 


Created  By: 


SPLINE2 

Relation 

Contains  the  definition  of  a  beam  spline  for  interpolating  panels  and  bodies  for 
steady  and  unsteady  aeroelastic  analysis. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

MACROID 

Integer  >  0 

The  identification  of  the  aerodynamic 
macroelement  to  be  sphned 

BOXl , BOX2 

Integer  >  0 

The  identification  numbers  of  the  first  and 
last  boxes  on  the  macroelement  to  be 
interpolated  using  this  spline 

GRDSETID 

Integer  >  0 

The  identification  of  a  SETi  entry  which 
lists  the  structural  grid  points  to  which  the 
spline  is  attached 

FLEX 

Real  >  0.0 

Linear  attachment  flexibility 

DTOR 

Real  >  0.0 

Torsional  flexibility 

CID 

Integer 

Rectangular  coordinate  system  which 
defines  the  y-axis  of  the  spline 

DTHX,DTHY 

Real 

Rotational  attachment  flexibility  about  the 
x-axis  and  y-axis 

Module  IFF 


SPOINT 

Relation 

Contains  the  identification  numbers  of  those  points  to  be  used  as  scalar  points. 
Input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

EXTID 

Integer  >  0 

External  point  identification 

Module  IFF 
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Entity: 

Entity  IVpe: 
Description: 
Relation  Attributes: 


Created  By: 
Notes: 


STABCF 

Relation 

Rigid  body  stability  coefficients. 


NAME 

TYPE/KEY 

DESCRIPTION 

MACHINDX 

Integer 

Mach  number  index  of  associated  AIRFRC 

FARM 

String(8) 

Character  string  identifying  the  configuration 
parameter. 

SYMFLG 

Integer 

Symmetry  flag  for  the  parameter. 

PARMVAL 

Real 

Parameter  value  used  to  generate  the  "unit" 
forces. 

CL 

Real 

Lift  coefficient 

CD 

Real 

Drag  coefficient 

CS 

Real 

Sideforce  coefficient 

CMX 

Real 

Rolling  moment  coefficient 

CMY 

Real 

Pitching  moment  coefficient 

CMZ 

Real 

Yawing  moment  coefficient 

Module  STEADY 

1.  The  SYMFLG  values  are: 

=  1  Symmetric 

=  -1  Antisymmetric 

2.  FARM  identifies  the  physical  variable  whose  perturbation  generated  the  rigid 
coefficients.  There  are  six  accelerations  and  six  configuration  parameters 
whose  names  are  reserved  that  have  specisd  meaning.  Additional  FARM  val¬ 
ues  come  from  the  set  of  all  AESURF  control  surfaces  defined  and  the  FARM 
attribute  contains  the  user  supplied  label.  For  a  given  MINDEX  value,  the 
AIRFRC  matrix  has  one  column  (which  may  contain  only  zeros)  for  each  en¬ 
try  in  STABCF  in  the  order  of  the  STABCF  relation.  The  FARM  field  is  then: 


PARM 

VARIABLE 

NX 

Rigid  body  acceleration  in  drag/thrust  direction  (Produces  no 
forces,  but  included  for  completeness  to  allow  modification  of 
AIRFRC  columns  to  include  nonzero  terms) 

NY 

Rigid  body  acceleration  in  side  force  direction  (Produces  no 
forces,  but  included  for  completeness  to  allow  modification  of 
AIRFRC  columns  to  include  nonzero  terms) 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


FARM 

VARIABLE 

NZ 

Rigid  body  acceleration  in  plunge  direction  (Produces  no  forces, 
but  included  for  completeness  to  allow  modification  of  AIRFRC 
columns  to  include  nonzero  terms) 

PACCEL 

Rigid  body  acceleration  about  the  roll  axis.  (Produces  no  forces, 
but  included  for  completeness  to  allow  modification  of  AIRFRC 
columns  to  include  nonzero  terms) 

QACCEL 

Rigid  body  acceleration  about  the  pitch  axis.  (Produces  no 
forces,  but  included  for  completeness  to  allow  modification  of 
AIRFRC  columns  to  include  nonzero  terms) 

RACCEL 

Rigid  body  acceleration  about  the  yaw  axis.  (Produces  no 
forces,  but  included  for  completeness  to  allow  modification  of 
AIRFRC  columns  to  include  nonzero  terms) 

THKCAM 

Forces  arising  fi-om  the  effects  of  only  thickness  and  camber 
with  all  other  confi^ruration  parameters  set  to  zero. 

ALPHA 

Forces  arising  due  to  unit  angle  of  attack. 

BETA 

Forces  arising  due  to  a  unit  yaw  angle. 

PRATE 

Forces  arising  due  to  a  xinit  roll  rate. 

QRATE 

Forces  arising  due  to  a  unit  pitch  rate. 

RRATE 

Forces  arising  due  to  a  unit  yaw  rate 

surface 

Forces  arising  due  to  the  unit  deflection  of  the  AJESURF  control 
surface  named  in  the  PARM  field. 

SUPORT 

Relation 

Contains  the  definition  of  the  set  of  points,  as  input  from  the  Bulk  Data  file,  at  which 
the  user  desires  determinate  reactions  to  be  applied  to  a  free  body. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

GRIDl 

Integer  >  0 

Grid  or  scalar  point  identification 

COMPNTSl 

Integer  >  0 

Components  of  GRIDl 

Module  IFF 

1.  This  relation  will  be  used  by  the  MKUSET  relation  to  build  the  support  set. 
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Entity: 

Entity  IVpe: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


TABDMPl 

Relation 

Contains  modal  structural  damping  tables  for  use  in  flutter  analysis  as  input  from 
the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Set  identification  number 

TYPE 

Text  (4) 

Damping  type 

FI 

Real  >  0.0 

Frequency  value 

FBCD 

Tfext(4) 

A  character  attribute  to  process  SKIP  requests 

GI 

Real 

Damping  value 

GBCD 

Tfext  (4) 

A  character  attribute  to  process  SKIP  requests 

Module  IFF 


TABLEDl 

Relation 

Contains  tabular  function  data  for  generating  dynamic  loads  as  input  from  the  Biilk 
Data  file. 


. 

NAME 

TYPE/KEY 

DESCRIPTION 

TID 

Integer 

Table  identification  number 

XI 

Real 

Time  (or  frequency)  for  the  tuple 

YI 

Real 

Response  for  this  tuple 

STRXF 

Tfext(4) 

A  character  attribute  to  process  skip  requests 

STRYI 

Text  (4) 

A  character  attribute  to  process  skip  requests 

IFF 

1.  The  relation  is  used  in  subroutine  FRTABl  to  define  time  or  frequency  de¬ 
pendent  load. 
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Entity: 

Entity  Type: 
Description: 

Entity  Structure: 
Record: 

Created  By: 
Notes: 


Entity: 

Entity  IVpe: 
Description: 

Entity  Structure: 
Record: 

Created  By: 
Notes: 


TELM 

Unstructured 

Contains  the  element  thermal  loads  partitions  for  nondesigned  and  linearly  de¬ 
signed  elements  if  any  thermal  loads  have  been  defined  in  the  model. 


i.  Each  record  contains  the  thermal  loads  partitions  for  each  nondesigned  and 
linear  designed  element  in  the  model  if  any  thermal  loads  have  been  defined 
in  the  model. 

Module  EMG 

1.  This  entity  contains  one  record  for  each  partition  of  each  element  thermal 
loads  matrix.  A  partition  is  that  portion  of  the  matrix  connected  to  one  pivot 
sil. 

2.  Refer  to  the  DVCT  relation  documentation  for  further  details. 

3.  The  TELM  terms  are  stored  in  the  same  precision  as  the  PG  matrix. 

4.  The  records  related  to  nonlinear  designed  elements  are  empty. 

5.  TELM  and  DTELM  are  used  to  generate  all  of  the  element  thermal  load  sen¬ 
sitivity  matrix  partitions. 

6.  TELM  and  TELMD  are  used  to  generate  all  of  the  element  thermal  load  ma¬ 
trix  partitions. 


TELMD 

Unstructured 

Contains  the  element  thermal  loads  partitions  for  nonlinear  design  elements  if  any 
thermal  loads  have  been  defined  in  the  model. 


i.  Each  record  contains  the  thermal  loads  partitions  for  each  nonlinear  design 
element  in  the  model  if  any  thermal  loads  have  been  defined  in  the  model. 

Module  NLEMG 

1.  This  entity  contains  one  record  for  each  partition  of  each  nonlinear  design  ele¬ 
ment  thermal  loads  matrix.  A  partition  is  that  portion  of  the  matrix  con¬ 
nected  to  one  pivot  sil. 

2.  Refer  to  the  DVCTD  relation  documentation  for  further  details. 

3.  The  TELMD  terms  are  stored  in  the  same  precision  as  the  PG  matrix. 

4.  TELMD  and  TELM  are  used  to  generate  all  of  the  element  thermal  load  ma¬ 
trix  partitions. 
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Entity: 

Entity  IVpe: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


TEMP 

Relation 

Contains  the  grid  point  temperatures  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer 

The  set  identification  number 

GRIDl 

Integer 

The  grid  point  id 

TEMPVAL 

Real 

The  value  of  temperattire  assigned  to  GRIDl 

Module  IFF 

TEMPD 

Relation 

Contains  the  default  grid  point  temperature  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer 

The  set  identification 

TEMPDVAL 

Real 

The  default  grid  point  temperature  for  the  set 
SETID  1 

Module  IFF 


761 


Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


TF 

Relation 

Contains  the  definition  of  transfer  functions  as  input  from  the  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer 

Set  identification  number 

GD 

Integer 

Grid,  scalar  or  extra  point  id 

CD 

Integer 

Component  number  of  grid  point  GD 

BO 

Heal 

Zeroth  order  coefficient 

B1 

Real 

First  order  coefficient 

B2 

Real 

Second  order  coefficient 

GI 

Integer 

Grid,  scalar  or  extra  point  id 

Cl 

Integer 

Component  number  of  grid  point  GI 

1 

Real 

Zeroth  order  coefficient 

II 

Real 

First  order  coefficient 

A2I 

Real 

Second  order  coefficient 

Created  By: 


Module  IFF 


Entity: 

Entity  Type: 
Description: 
Entity  Structure: 
Record: 


Created  By: 
Notes: 


TFDATA 

Unstructured 

Contains  the  collected  transfer  function  data  for  all  transfer  function  sets  defined. 


1.  A  list  of  all  set  identification  numbers  in  sorted  order 
i.  Contains  the  transfer  function  for  the  (i-l)th  transfer  function  set.  Each  re¬ 
cord  has  the  following  form: 


WORD 

VARIABLE 

DESCRIPTION 

1 

SID 

Set  identification  for  the  (i-l)th  transfer  function 
set 

j 

COL 

Internal  number  of  the  matrix  column  affected  by 
the  transfer  function 

j+1 

NROW 

Number  of  terms  defined  in  the  column  COL 

j+2  to 

j+l+4*NROW 

For  each  term  in  the  colrunn  four  words  are  stored: 

1)  Internal  number  of  the  matrix  row 

2)  0th  order  coefficient 

3)  1st  order  coefficient 

4)  2nd  order  coefficient 
in  sorted  row  order 

PFBULK 

1.  This  entity  is  used  in  DMA  to  assemble  dynamic  matrices. 

2.  The  j  index  runs  from  1  to  NCOL  for  each  column  in  the  matrix  that  is  af¬ 
fected  by  the  transfer  function  terms  in  sorted  column  order. 
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TFIXED 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Notes: 

Entity: 

Entity  Type: 
Description: 
Relation  Attributes: 


Created  By: 


Relation 

Contains  the  layer  thicknesses  of  undesigned  layers  of  designed  composite  ele¬ 
ments. 


NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0 

Element  identification  number 

ETYPE 

Text  (8) 

Element  t3T)e.  One  of  the  following; 

QDMEMl  QUAD4 

TRMEM  TRIAS 

LAYRNUM 

Integer  >  0 

Layer  number 

T 

Real  >  0.0 

Thickness 

MAKEST 

1.  These  thicknesses  are  used  in  the  evalation  of  thickness  constraints  and  com¬ 
posite  laminate  constraints 


THKDRVA 

Relation 

Contains  the  user  function  requested  element  thickness  sensitivity  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

MXCOL 

Integer  >  0 

Matrix  column  number  in  [MXTHKDVA]  for 
the  sensitivity  values 

Module  MAKDFV 
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Entity: 

Entity  T^pe: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 


THKRESP 

Relation 

Contains  the  user  function  requested  element  thickness  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number  j 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

1  VALUE 

Real 

Response  value  | 

Module  TCEVAL. 

TIMELIST 

Relation 

Contains  the  list  of  times  for  which  outputs  are  requested  as  input  from  the  Bulk 
Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer 

Set  identification  number 

TIME 

Real 

Time  value  in  consistent  units 

Module  IFF 
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Entity: 

Entity  I^pe: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


TLOADl 

Relation 

Contains  information  on  time  dependent  loads  as  defined  on  the  TLOADl  bulk  data 
entry. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0,  key 

Set  identification  number 

IDEL 

Integer  >  0 

ID  of  the  DLAGS  set 

TABLl 

Integer 

ID  of  the  TABLED  1  set 

Module  IFF 
Notes: 

1.  The  relation  is  used  in  module  OFFLOAD  to  generate  dynamic  loads. 


TLOAD2 

Relation 

Contains  information  on  time  dependent  loads  as  defined  by  the  TLOAD2  bulk  data 
entry. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0,  key 

Set  identification  number 

IDEL 

Integer  >  0 

ID  of  the  DLAGS  set 

T1 

Real  >  0.0 

Time  constant 

T2 

Real  >  T 

Time  constant 

FREQ 

Real  >  0.0 

Frequency  parameter 

PHASE 

Real 

Phase  parameter 

CTEXP 

Real 

Exponential  coefficient 

GROWTH 

Real 

Growth  coefficient 

Module  IFF 


1.  The  relation  is  used  in  module  OFFLOAD  to  generate  d5niamic  loads. 


Entity: 

TMN 

Entity  Type: 

Subscripted  Matrix 

Description: 

Contains  the  rigid  constraint  matrix  relating  the  displacements  at  dependent 
degrees  of  freedom  to  those  at  the  independent  degrees  of  freedom. 

Matrix  Form: 

A  variable-sized  single  precision  matrix  having  one  row  for  each  dependent  degree 
of  freedom  and  one  column  for  each  independent  degree  of  freedom.  The  rigid 
constraint  matrix  is  built  from  MFC  and  rigid  elements  such  that: 

[Um]  =  [TMN]  [Un] 

Created  By: 

Notes: 

Module  MKUSET 

1.  The  dimension  of  this  subscripted  matrix  must  be  large  enough  for  all  optimi¬ 
zation  and  analysis  boundary  conditions. 

2.  If  no  multipoint  constraints  are  defined,  this  matrix  will  have  no  columns. 

Entity: 

TMPl 

Entity  Type: 

Matrix 

Description: 

A  scratch  matrix  used  at  various  points  in  the  MAPOL  sequence  for  intermediate 
calculation. 

Matrix  Form: 

Application  dependent. 

Created  By: 

MAPOL 

Entity: 

TMP2 

Entity  Type: 

Matrix 

Description: 

A  scratch  matrix  used  at  various  points  in  the  MAPOL  sequence  for  intermediate 
calculation. 

Matrix  Form: 

Apphcation  dependent. 

Created  By: 

MAPOL 
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TREF 


Entity: 

Entity  Type:  Unstructured 

Description:  Contains  the  element  reference  temperature  for  each  linear  design  element  in  the 

model. 

Entity  Structure: 

Record: 

1.  Contains  the  reference  temperature  for  each  linear  design  element  in  the 
model.  The  temperatures  are  stored  in  the  order  the  elements  are  processed. 

Created  By:  Modiile  EMG 

Notes: 

1.  Elements  are  processed  alphabetically  by  element  type  and  numerically 
within  each  element  type. 

2.  Entity  is  only  created  if  TEMP  or  TEMPD  bulk  data  entries  exist. 

3.  The  TREFPT  attribute  on  the  XXXEST  relations  points  to  the  position  in 
TREF  for  the  associated  reference  temperature. 

Entity:  TREFD 

Entity  TVpe:  Unstructured 

Description:  Contains  the  element  reference  temperature  for  each  nonlinear  design  element  in 

the  model. 

Entity  Structure: 

Record: 

1.  Contains  the  reference  temperature  for  each  nonlinear  design  element  in  the 
model.  The  temperatures  are  stored  in  the  order  the  elements  are  processed. 

Created  By:  Module  NLEMG 

Notes: 

1.  Elements  are  processed  alphabetically  by  element  type  and  nximerically 
within  each  element  type. 

2.  Entity  is  only  created  if  TEMP  or  TEMPD  bulk  data  entries  exist. 

3.  The  TREFPT  attribute  on  the  XXXEST  relations  points  to  the  position  in 
TREF  for  the  associated  reference  temperature. 


TRIM 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Relation 

Contains  the  specified  conditions  for  steady  aeroelastic  trim  or  nonplanar  steady 
aerod5mamic  analysis  as  input  from  Bulk  Data  file. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Trim  set  identification  number 

MACH 

Real  >  0.0 

Mach  number 

QDP 

Real  >  0.0 

Dynamic  pressure 

TRMTYP 

IfextCS) 

Type  of  trim  desired 

EFFID 

Integer 

Identification  of  CONEFFS  bulk  data  entries 
which  modify  control  surface  effectiveness 
values 

VO 

Real 

Velocity 

LABELI 

Tfext(8) 

Label  defining  the  aerod)niamic  trim 
parameters 

FREEI 

’Ife3d;(4) 

Character  string  FREE 

— 

FIXI 

Real 

Magnitude  of  the  trim  parameter 

Created  By: 


Modiale  IFF  and  STEADY 


Entity: 

Entity  lype: 
Description: 

Relation  Attributes: 


Created  By: 


TRIMDATA 

Relation 

Contains  the  TRIM  Bulk  Data  and  related  boundary  condition,  subcase  and  sub¬ 
script  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

SETID 

Integer  >  0 

Trim  set  identification  number 

MACH 

Real  >  0.0 

Mach  number 

QDP 

Real  >  0.0 

Dynamic  pressure 

TRMTYP 

TtextCS) 

Type  of  trim  desired 

EFFID 

Integer 

Identification  of  CONEFFS  bulk  data  entries 
which  modify  control  surface  effectiveness 
values 

VO 

Real 

Velocity 

LABEL I 

Text(8) 

Label  defining  the  aerodynamic  trim 
parameters 

FREEI 

lbxt(4) 

Character  string  FREE 

FIXI 

Real 

Magrdtude  of  the  trim  parameter 

BCID 

Integer 

Boundary  condition  identification  number  | 

MACHINDX 

Integer 

Mach  number  index  for  the  current  subcase  1 

SYMMFLAG 

Integer 

S3Tmnetry  option  for  the  Mach  Number  | 

SUBSCRPT 

Integer 

Subscript  counter 

SUBCASID 

Integer 

Subcase  identification  number 

Module  TRIMCHEK 
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TRIMDRVA 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Relation 

Contains  the  user  function  requested  steady  aeroelastic  trim  parameter  response 
sensitivity  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

MXCOL 

Integer  >  0 

Matrix  column  number  in  [MXTRMDVA]  for 
the  sensitivity  values  1 

Module  AEROSENS 


TRIMRESP 

Relation 

Contains  the  user  function  requested  steady  aeroelastic  trim  parameter  response 
values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value 

Created  By: 


Module  SAERO 


Entity: 

Entity: 

Description: 
Relation  Attributes: 


TRIA3EST 

Relation 

Contains  the  element  summaiy  data  for  the  triangular  TRIAS  element. 


NAME 

TYPE/KEY 

DESCRIPTION  1 

EID 

Integer  >  0 

Element  identification  number  [ 

PID 

Integer  >  0 

Element  property  identification  number 

PTYPE 

Text  (8) 

Element  property  type 

LAYRNUM 

Integer  >  0 

Composite  layer  number 

SILl 

Integer  >  0 

Internal  grid  point  id  1 

SIL2 

Integer  >  0 

Internal  grid  point  id  2 

SIL3 

Integer  >  0 

Internal  grid  point  id  3 

TRATIOl 

Real  >  0.0 

Ratio  of  membrane  thickness  to  element 
thickness  for  grid  1 

TRATI02 

Real  >  0.0 

Ratio  of  membrane  thickness  to  element 
thickness  for  grid  2 

TRATI03 

Real  >  0.0 

Ratio  of  membrane  thickness  to  element 
thickness  for  grid  3 

CIDl 

Integer  >  0 

Coordinate  system  defining  material  axis 

THETAM 

Real 

Material  orientation  angle 

OFFSTO 

Real 

Initial  ofEset  of  the  element  reference  plane 
from  the  plane  of  grid  points. 

MIDI 

Integer  >  0 

Material  identification  number  for  membrane 

THICK 

Real  >  0.0 

Membrane  thickness  | 

MID2 

Integer  >  0 

Material  identification  number  for  bending  | 

BENDSTIF 

Real  >  0.0 

Bending  stiffiiess  parameter 

MID3 

Integer  >  0 

Material  identification  number  for  transverse 
shear 

TRNSVRS 

Real  >  0.0 

Transverse  shear  thickness  factor 

NSM 

Real  >  0.0 

Nonstructural  mass 

FZl 

Real  >  0.0 

Fiber  distance  for  stress  computation 

FZ2 

Real  >  0.0 

Fiber  distance  for  stress  computation 

MID4 

Integer  >  0 

Material  identification  number  for  membrane¬ 
bending  coupling 
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NAME 


TYPE/KEY 


DESCRIPTION 


CIDS 


Integer  >  0 


THETAS 


Real 


COORDl 


Integer 


XI,  Yl,  Z1 


Real 


COORD2 


Integer  >  0 


X2,  Y2,  Z2 


Real 


COORD3 


Integer  >  0 


X3,  Y3,  Z3 


Real 


SCON 


Integer 


DESIGN 


Integer 


STHRM 


RealArrayO) 


STHRMA 


RealArray(3) 


TREFPT 


Integer  >  0 


NLFLAG 


Integer  >  0 


ELRSPREQ 


Integer 


LAYERPOS 


Integer 


Coordinate  system  defining  stress  output 
coordinate  system _ 

Stress  output  orientation  angle _ _ 

External  coord  system  for  SILl _ 

Basic  coordinates  of  SILl _ 

External  coord  system  for  SIL2 _ 

Basic  coordinates  of  SIL2 _ _ 

External  coord  system  for  SIL3 _ _ 

Basic  coordinates  of  SIL3 _ 

Stress  constraint  flag _ 

Design  flag _ _ 

Thermal  stress  terms  for  the  constrained 
element _ 

Thermal  strain  terms  for  the  constrained 
element _ _ _ 

Pointer  to  the  TREE  entity  for  thermal 
loads/stress  evaluation  of  the  designed  element 

Nonlinear  design  variable  flag 
=  0  Linear  design  variable 
=  1  Nonzero,  nonstructural  mass  (NSM  ^  0) 

=  2  Nonlinear  design  stiffiiess 
=  3  Nonlinear  design  stiffiiess  and 
NSM  0 

=  4  Nonlinear  design  stiffiiess  and  design 
mass 

=  5  Nonlinear  design  stiffiiess  and  mass  and 
NSM;6  0 _ 

User  function  element  response  flag 
=  1  Element  response  required 
=  0  Element  response  not  required _ 

This  layer’s  position  among  all  composite  layers 
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Created  By: 
Notes: 


NAME 

TYPE/KEY 

DESCRIPTION 

CMPFLG 

Integer  >  0 

Composite  element  type  flag 

=  0  Noncomposite  element 
(1  entry  for  layer  "0”) 

=  1  Nondesigned  and  nonconstrained 

composite  element  (1  entry  for  layer  ”0” 
for  equiv.  single  layer) 

=  2  Nondesigned  and  constrained  composite 
element  (1  entry  for  layer  "0"  for 
equiv.  single  layer  and  nlayer  entries  at  I 
each  layer) 

=  3  Designed  membrane  composite  element 
entries  at  each  layer 

=  4  Designed  bending  composite  element 
(1st  entry  for  equiv.  single  layer  and 
entries  at  each  layer) 

ELTHKO 

Real  >  0.0 

Initial  user  input  membrane  thickness 

Module  MAKEST 

1.  This  relation  is  built  from  the  CTRIA3,  associated  P-type  and  the  basic  grid 
point  data.  It  contains  one  tuple  for  each  isoparametric  TRIAS  element  in 
the  problem. 

2.  The  number  of  EST  entries  for  a  composite  element  could  be  equal  to  the 
niunber  of  layers,  or  to  the  number  of  layers  +  one,  depending  on  the  compos¬ 
ite  type.  (See  preceeding  CMPFLG  description) 
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Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


TRKEIMEST 

Relation 

Contains  the  element  summary  data  for  the  constant  strain  triangular  membrane 
element. 


1  NAME 

TYPE/KEY 

DESCRIPTION 

EID 

Integer  >  0,  key 

Element  identification  number 

PID 

Integer  >  0 

Element  property  identification  number 

PTYPE 

Tsxt  (8) 

Element  property  type 

LAYRMJM 

Integer  >  0 

Composite  layer  number 

SILl 

Integer  >  0 

Internal  grid  point  id 

SIL2 

Integer  >  0 

SIL3 

Integer  >  0 

CID 

Integer  >  0 

Coordinate  system  defining  material  axis 

THETA 

Real 

Material  orientation  angle  for  anisotropic 
material  behavior  j 

MIDI 

Integer  >  0 

Material  id  of  MATl  tuple 

THICK 

Real  >  0.0 

Element  thickness 

NSM 

Real  >  0.0 

Element  nonstructural  mass 

COORDl 

Integer  >  0 

External  coordinate  system  id  for 
displacements  at  SILl 

XI,  Yl,  Z1 

Real 

External  coordinate  system  id  for 
displacements  at  SILl 

1  COORD2 

Integer  >  0 

External  coordinate  system  id  for  1 

displacements  at  SIL2 

X2,  ¥2,  Z2 

Real 

External  coordinate  system  id  for 
displacements  at  SIL2 

COORDS 

Integer  >  0 

External  coordinate  system  id  for  1 

displacements  at  SIL3  | 

X3,  Y3,  Z3 

Real 

External  coordinate  system  id  for  | 

displacements  at  SIL3 

SCON 

Integer 

Stress  constraint  flag 

DESIGN 

Integer 

Design  flag 

STHRM 

Real  Array  (3) 

Thermal  stress  terms  for  the  constrained 
element 
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Created  By: 
Notes: 


NAME 

TYPE/KEY 

DESCRIPTION 

STHRMA 

Real  Array  (3) 

Thermal  strain  terms  for  the  constrained 
element 

TREFPT 

Integer  >  0 

Pointer  to  TREF  entity  used  to  evaluate 
thermal  loads  and  thermal  stresses 

NLFLAG 

Integer  >  0 

Nonlinear  design  variable  flag 
=  0  linear 
=  1  NSM^O 

ELRSPREQ 

Integer 

User  function  element  response  flag 
=  1  Element  response  required 
=  0  Element  response  not  required 

Module  MAKEST 

1.  This  relation  is  built  from  the  CTRMEM,  associated  P-type  and  the  basic  grid 
point  relations.  It  contains  one  tuple  for  each  triangular  membrane  element 
in  the  problem. 

2.  A  nonzero  SCON  flag  denotes  that  the  element  is  affected  by  a  stress  con¬ 
straint. 

3.  A  nonzero  DESIGN  flag  denotes  that  the  element  is  affected  by  a  design 
variable. 

4.  LAYRNUM  is  zero  for  noncomposite  elements. 


Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


TSTEP 

Relation 

Contains  time  step  information  for  the  dynamic  response  as  input  from  the  Bulk 
Data  file. 


Created  By: 
Notes: 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer  >  0 

Time  step  identification  number 

NDTI 

Integer  >  2 

Number  of  time  steps  for  this  tuple 

DELTAI 

Real  >  0.0 

Time  increment  for  this  tuple 

NOUTI 

Integer 

Skip  factor  for  this  tuple 

Module  IFF 

1 .  The  response  at  every  NOUTIth  time  step  will  be  saved  for  output. 


Entity: 

Entity  IVpe: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


UA 

Matrix 

Displacements  in  the  a-set. 

A  variable-size  matrix  having  one  row  for  each  degree  of  freedom  in  the  analysis  set 
and  one  column  for  each  load  condition  in  the  CTurent  boundary  condition. 

See  Notes. 

1.  This  matrix  is  calculated  using: 

[Kill lUA]  =  [PI] 

if  there  is  inertia  rehef, 

[UA]  =  [K1112] [AR]  +  [PAR] [DELTA] 

for  static  aeroelasticity,  and 
[KAA]  [UA]  =  [PA] 

for  static  analysis  without  inertia  rehef 

2.  SeeUG. 
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Entity: 

Entity  T^pe: 
Description: 
Matrix  Form: 

Created  By: 

Entity: 

Entity  IVpe: 
Description: 
Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 
Record: 


Created  By: 
Notes: 

Entity: 
Entity  Type: 
Description: 


UBLASTG 

Matrix 

Blast  response  quantities  in  the  g-set. 

Real  rectangular  matrix  with  one  row  for  each  g-set  degree  of  freedom  and  three 
columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each  time 
step  at  which  transient  calculations  are  retained. 

MAPOL 

UBLASTI 

Matrix 

Blast  response  quantities  in  the  i-set. 

Real  rectangular  matrix  with  one  row  for  each  retained  mode  and  three  columns 
(corresponding  to  displacement,  velocity,  and  acceleration)  for  each  time  step  at 
which  transient  calculations  are  retained. 

BLASTDRV 

UDLOLY 

Unstructured 

Contains  collected  DLONLY  information. 

1.  ID’s  of  the  NDIS  DLONLY  sets  in  sorted  order.  Contains  data  for  the  (i-l)th 
DLONLY  set.  The  information  on  each  of  these  records  is: 


WORD  NO 

VARIABLE 

DESCRIPTION 

j 

LOAD 

Load  factor 

D+1 

ISIL 

Internal  ID  of  load  component 

Module  PFBULK 

1.  The  number  of  words  for  the  ith  record  is  twice  the  number  of  load  factors  in¬ 
put  for  the  associated  set  ID. 


UF 

Matrix 

Displacements  in  the  f-set  derived  from  UO  and  UA(see  UG). 
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Entity: 

Entity  Type: 
Description: 
Matrix  Form: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 

Entity: 
Entity  Type: 
Description: 
Matrix  Form 

Created  By: 


UFREQA 

Matrix 

Matrix  of  frequency  response  quantities  in  the  a-set. 

A  complex  rectangular  matrix  with  one  row  for  each  a-set  degree  of  freedom  and 
three  columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each 
frequency  at  which  frequency  response  output  is  required. 

Module  DYNRSP  or  MAPOL 

1.  If  the  direct  method  of  frequency  response  is  used,  UFREQ  is  computed  in 
module  DYNRSP.  If  the  modal  method  is  used,  UFREQA  is  recovered  using 
UFREQI  and  PHIA. 

UFREQE 

Matrix 

Matrix  of  frequency  response  quantities  in  the  e-set. 

A  complex  rectangular  matrix  with  one  row  for  each  e-set  degree  of  freedom  and 
three  coliimns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each 
frequency  at  which  frequency  response  output  is  required. 

Module  DYNRSP 

1.  UFREQE  is  only  computed  in  a  frequency  response  analysis  that  includes  ex¬ 
tra  points. 

UFREQF 

Matrix 

Matrix  of  frequency  response  quantities  in  the  f-set. 

A  complex  rectangular  matrix  with  one  row  for  each  f-set  degree  of  freedom  and 
three  columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each 
frequency  at  which  frequency  response  output  is  required. 

MAPOL 

UFREQG 

Matrix 

Matrix  of  frequency  response  quantities  in  the  g-set. 

A  complex  rectangular  matrix  with  one  row  for  each  g-set  degree  of  freedom  and 
three  columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each 
frequency  at  which  frequency  response  output  is  required. 

MAPOL 
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Entity:  UFREQI 

Entity  lype:  Matrix 

Description:  Matrix  of  frequency  response  quantities  in  the  i-set. 

Matrix  Form:  A  complex  rectangular  matrix  with  one  row  for  each  i-set  degree  of  freedom  and 

three  columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each 
frequency  at  which  frequency  response  output  is  required. 

Created  By:  Module  DYNRSP 

Notes: 

1.  This  matrix  is  only  computed  when  the  modal  method  of  frequency  response 
is  invoked. 

Entity:  UFREQN 

Entity  Type:  Matrix 

Description:  Matrix  of  frequency  response  quantities  in  the  n-set. 

Matrix  Form:  A  complex  rectangular  matrix  with  one  row  for  each  n-set  degree  of  freedom  and 

three  columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each 
frequency  at  which  frequency  response  output  is  required. 

Created  By:  MAPOL 

Entity:  UG 

Entity  Type:  Subscripted  Matrix 

Description:  Displacements  of  the  structural  degrees  of  freedom  in  the  g-set. 

Matrix  Form:  A  variable-sized  matrix  having  one  row  for  each  structural  degree  of  freedom  and 

one  column  for  each  load  condition  in  the  boimdary  condition. 

Created  By:  MAPOL 

Notes: 

1.  The  MAPOL  sequence  recovers  this  matrix  in  the  following  order  (see  the 
Theoretical  Manual  for  the  explicit  form  of  this  recovery): 
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Entity: 

Entity  Type: 
Description: 
Matrix  Form: 
Created  By: 
Notes: 

Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  lype: 
Description: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


UGA 

Matrix 

"Active"  displacements  vectors  for  the  current  boimdary  condition. 

The  matrix  has  one  coliimn  for  each  active  displacement  vector  and  GSIZE  rows. 
MAPOL 

1.  This  matrix  is  obtained  by  partitioning  UG  using  the  PGA  partitioning  vector. 

UGTKAB 

Matrix 

A  partition  of  the  UGTKF  matrix  (see  UGTKG). 

UGTKA 

Matrix 

Unsteady  spline  matrix  in  the  a-set  derived  from  UGTKF  (see  UGTKG). 

UGTKF 

Matrix 

Unsteady  spline  matrix  in  the  f-set  derived  from  UGTKN  (see  UGTKG). 

UGTKG 

Matrix 

Matrix  containing  the  spline  relations  which  relate  the  structural  and  unsteady 
aerodynamics  models 

Real  rectangular  matrix  with  one  row  for  each  g-set  degree  of  freedom  and  one 
column  for  each  aerodynamic  degree  of  freedom. 

Module  SPLINEU 

1.  The  MAPOL  sequence  supports  the  following  partitions  of  the  UGTKG  ma¬ 
trix  (see  the  Theoretical  Manual  for  the  exact  formation  of  these  matrices): 

^  ' 

UGTKN 

=  [UGTKAB]  +  [GSUBO] [UGTKO] 


[UGTKG] 

[UGTKA] 
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Entity: 

Entity  TVpe: 
Description: 

Entity: 
Entity  T^pe: 
Description: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  by: 
Notes: 

Entity: 

Entity  Type: 
Description: 

Entity: 

Entity  Type: 
Description: 


U6TKN 

Matrix 

Unsteady  spline  matrix  in  the  n-set  derived  from  UGTKG  (see  UGTKG). 

UGTKO 

Matrix 

Unsteady  spline  matrix  in  the  o-set  obtained  as  a  partition  of  UGTKF  (see  UGTKG). 

UKQ 

Matrix 

Upper  triangular  portion  of  the  decomposed  KEQE  matrix. 

Square  real  matrix  having  one  row  and  column  for  each  elastic  mode  retained  in  the 
nuclear  blast  response  analysis. 

DECOMP 

1.  KEQE  is  not  symmetric. 

2.  This  matrix  is  formed  for  use  by  the  GFBS  large  matrix  utility. 

Matrix 

Displacements  in  the  m-set  derived  from  UN  and  TMN  (see  UG). 

UN 

Matrix 

Displacements  in  the  n-set  derived  from  UF  and  YS  (see  UG). 


782 


Entity: 

Entity  Type: 
Description: 

Entity  Structure: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


UNMK 

Unstructured 

Contains  a  global  list  of  Mach  niimber  and  reduced  frequency  pairs  for  which 
aerodynamic  matrices  were  generated  in  the  aerodjmamic  matrix  lists. 


RECORD 

WORDS 

DESCRIPTION 

1 

1 

1-6 

A  one-word  entry  for  each  combination  of 
symmetry  options  in  the  order  noted  containing 
the  number  of  m-k  pairs  having  the  particular 
symmetry  option 

7 

Thru 

6+4*nink 

Contains  one  four  word  entry  for  each  aerodynamic 
matrix  selected  for  generation  by  the  MKAEROi 
entries  of  the  following  form: 

M.  K,  SYMXZ.  SYMXY 

2 

1 

Thru 

2*BGRP 

Contains  the  number  of  j  degrees  of  freedom  and 
the  number  of  k  degrees  of  freedom  for  each 
unsteady  aerodynamic  group 

Module  UNSTEADY 


1 .  Record  1  is  sorted  first  by  Mach  number  (M)  and  then  by  reduced  frequency 
(k)  within  each  M  value  for  each  combination  of  symmetry  values.  The  sym¬ 
metry  options  are  treated  in  the  following  order: 


ORDER 

SYMXZ 

SYMXY 

1 

-1 

-1 

2 

-1 

0 

3 

0 

-1 

4 

0 

0 

5 

1 

-1 

6 

1 

0 

UO 

Matrix 

Sensitivities  of  displacements  in  the  o-set. 

A  real  rectangular  matrix  with  one  row  for  each  o-set  degree  of  freedom  and  one 
column  for  each  active  subcase  times  the  number  of  design  variables. 

MAPOL 

1.  For  static  aeroelastic  analysis,  UO  is  computed  fi*om: 

[UO]  =  [GASUBO]  [DXJAV]  +  [UOO] 

2.  For  inertia  relief,  UO  is  computed  from: 

[UO]  =  [GSUBO]  [DUAV]  +  [UOO] 
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Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


Entity: 

Entity  TVpe: 
Description: 

Matrix  Form: 

Created  By: 


uoo 

Matrix 

Intermediate  displacement  sensitivities  of  the  o-set. 

A  real  rectangular  matrix  with  one  row  for  each  o-set  degree  of  freedom  and  one 
column  for  each  active  subcase  times  the  number  of  design  variables. 

GFBS 

1.  UOO  is  computed  from: 

[KAOO]  [UOO]  =  [  [DPOV]  +  [POARO]  [DDELDV]  ] 

2.  For  inertia  relief,  UOO  is  computed  from: 

[KAOO] [UOO]  =  [  [DPOV]  +  [IFM] [DUAD]  ] 


URDB 

Matrix 

Vector  of  aircraft  rigid  body  accelerations  that  are  computed  for  aircraft  trim  prior 
to  the  nuclear  blast  response  calculation. 

Real  rectangular  matrix  having  two  rows  (vertical  and  angular  acceleration)  and 
one  column. 

BLASTRIM 
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Entity: 

Entity  Type: 
Description: 

Entity  Structure: 
Record: 


Created  By: 
Notes: 


Entity: 

Entity  Type: 
Description: 
Matrix  Form: 


Created  By: 
Notes: 


USET 

Unstructured 

Contains  the  bit  masks  defining  the  structural  sets  to  which  the  degrees  of  freedom 
belong. 


i  Each  record  contains  the  boundary  condition  id  as  the  first  word  followed  by 
one  word  for  each  dependent  set  containing  the  number  of  DOF  in  each  de¬ 
pendent  set.  These  are  followed  by  one  word  for  each  degree  of  fi*eedom  con¬ 
taining  the  bit  masks  defining  the  structural  sets  to  which  they  belong. 

Module  MKUSET 

1.  This  entity  contains  one  record  for  each  boundary  condition  in  the  problem. 

2.  The  bit  masks  are  used  to  generate  matrix  partitioning  vectors. 

3.  The  11th  word  of  the  INFO  array  for  this  entity  contains  the  number  of  de¬ 
grees  of  freedom  in  the  structur^  model  (g-  set  size). 

4.  The  USET  header  has  the  following  form: 

WORD  DESCRIPTION 

1  Boundary  condition  id 

2  Number  of  m-set  dofs 

3  Nvunber  of  s-set  dofs 

4  Number  of  o-set  dofs 

5  Number  of  r-set  dofs 

UTRANA 

Matrix 

Matrix  of  transient  response  quantities  in  the  a-set. 

Complex  rectangular  matrix  with  one  row  for  each  a-set  degree  of  fireedom  and  tluee 
columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each  time 
step  at  which  transient  response  output  is  required. 

Module  DYNRSP  or  MAPOL 

1.  If  the  direct  method  of  transient  response  is  used,  UTRANA  is  computed  in 
module  DYNRSP.  If  the  modal  method  is  used,  UTRANA  is  recovered  using 
UTRANIandPHIA. 


Entity: 
Entity  Type: 
Description: 
Matrix  Form; 

Created  By: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By; 

Entity: 

Entity  Type: 
Description: 
Matrix  Form: 

Created  By: 
Notes: 


UTRANE 

Matrix 

Matrix  of  frequency  response  quantities  in  the  e-set. 

Complex  rectangular  matrix  with  one  row  for  each  e-set  degree  of  freedom  and  three 
columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each  time 
step  at  which  transient  response  output  is  required. 

Module  DYNRSP 

UTRANF 

Matrix 

Matrix  of  frequency  response  quantities  in  the  f-set. 

Complex  rectangular  matrix  with  one  row  for  each  f-set  degree  of  freedom  and  three 
columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each  time 
step  at  which  transient  response  output  is  required. 

MAPOL 

UTRAN6 

Matrix 

Matrix  of  frequency  response  quantities  in  the  g-set. 

Complex  rectangular  matrix  with  one  row  for  each  g-set  degree  of  freedom  and  three 
columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each  fre¬ 
quency  at  which  frequency  response  output  is  required. 

MAPOL 

UTRANI 

Matrix 

Matrix  of  frequency  response  quantities  in  the  i-set. 

Complex  rectangular  matrix  with  one  row  for  each  i-set  degree  of  freedom  and  three 
columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each  time 
step  at  which  transient  response  output  is  required. 

Module  DYNRSP 

1.  This  mato  is  only  computed  when  the  modal  method  of  transient  response 
analysis  is  invoked. 
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Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 

Entity: 

Entity  IVpe: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Relation  Attributes: 


Created  By: 
Notes: 


UTRANN 

Matrix 

Matrix  of  frequency  response  quantities  in  the  n-set. 

Complex  rectangular  matrix  with  one  row  for  each  n-set  degree  of  freedom  and  three 
columns  (corresponding  to  displacement,  velocity,  and  acceleration)  for  each  time 
step  at  which  transient  response  output  is  required. 

MAPOL 

VELOLIST 

Relation 

Contains  the  list  of  velocity  values  as  input  from  the  Bulk  Data  file. 


1  NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer 

Set  identification  number 

VELOCITY 

Real  >  0.0 

Velocity  value 

Module  IFR 

VSDAMP 

Relation 

Contains  the  specification  of  parameters  used  to  generate  viscous  damping  terms 
in  the  dynamic  matrices. 


NAME 

TYPE/KEY 

DESCRIPTION 

SID 

Integer 

Set  identification  number 

GVAL 

Real 

Damping  value 

OMEGA3 

Real 

Cyclic  frequency 

Module  IFF 

1.  If  both  GVAL  and  OMEGAS  are  nonzero,  equivalent  structural  damping  is 
used  to  generate  the  BDD  and/or  BHH  entities. 

2.  If  only  GVAL  is  nonzero,  structural  damping  is  used  for  direct  or  modal  fre¬ 
quency  or  flutter  analyses. 
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Entity: 

Entity  IVpe: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  lype: 
Description: 
Relation  Attributes: 


Created  By: 

Entity: 

Entity  Type: 
Description: 

Matrix  Form: 

Created  By: 
Notes: 


W6HDRVA 

Relation 

Contains  the  user  function  requested  element  weight  sensitivity  information. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

MXCOL 

Integer  >  0 

Matrix  column  number  in  [MXWGHDVA]  for 
the  sensitivity  values 

Module  MSWGGRAD 

W6HRESP 

Relation 

Contains  the  user  function  requested  element  weight  values. 


NAME 

TYPE/KEY 

DESCRIPTION 

INSTANCE 

Integer 

User  function  instance  number 

POSITION 

Integer 

Vector  (2) 

Response  position  index 

VALUE 

Real 

Response  value 

Module  MSWGRESP 

YS 

Subscripted  Matrix 

Contains  the  column  vector  of  enforced  displacements  of  degrees  of  freedom  con¬ 
strained  by  single  point  constraints  (see  UG). 

A  variable-sized  single  precision  column  vector  having  one  row  for  each  single  point 
constraint  degree  of  freedom. 

Module  MKUSET 

1.  If  no  nonzero  enforced  displacements  are  specified  for  SPC’d  degrees  of  free¬ 
dom,  this  matrix  will  have  no  columns. 
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10.  APPLICATION  PROGRAMMER  NOTES 


One  of  the  strengths  of  the  ASTROS  architecture  is  the  ease  with  which  the  system  can  be 
modified  and  enhanced.  Therefore,  many  ASTROS  users  will  find  it  convenient  and  useful  to  write 
software  to  perform  special  purpose  tasks  within  the  ASTROS  environment  rather  than  in  the  more 
typical  post-processing  style.  That  is,  instead  of  writing  the  ASTROS  results  to  an  intermediate  medium 
to  be  read  by  the  special  routine,  the  new  feature  will  be  installed  into  the  ASTROS  system.  The  intent  of 
this  section  is  to  give  this  type  of  ASTROS  programmer  an  overview  to  writing  modules  that  interface 
with  the  ASTROS  system. 

Coding  standards  and  software  design  guidelines  are  given  to  create  a  module  that  functions 
within  the  ASTROS  architecture  without  creating  integration  problems.  Also,  informal  guidelines  to 
using  the  ASTROS  Dynamic  Memory  Manager  (DMM)  and  the  applications  interface  to  the  Computer 
Automated  Design  Database  (CADDB)  are  presented.  These  presentations  are  necessarily  limited  in 
scope  and  do  not  provide  a  comprehensive  guide  to  every  aspect  of  ASTROS  programming.  They  should, 
however,  be  sufficient  for  the  advanced  ASTROS  user  to  write  modules  to  perform  special  tasks  without 
(1)  duphcating  functions  that  already  exist  in  the  ASTROS  software  and  (2)  writing  code  that  causes 
errors  outside  the  module  being  written.  This  section  is  divided  into  four  subsections.  Subsection  10.1 
discusses  coding  standards  including  programming  language  and  modular  design.  Subsection  10.2  con¬ 
tains  suggestions  for  how  to  make  the  best  use  of  the  DMM,  while  subsection  10.3  is  concerned  with  the 
CADDB  features.  Finally,  Subsection  10.4  combines  these  topics  and  gives  guidelines  for  FO  and  system 
level  interfaces  within  the  ASTROS  architecture. 
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10.1.  SOFTWARE  STANDARDS 


ASTROS  was  designed  to  be  machine  transportable,  maintainable,  and  easy  to  enhance.  To 
achieve  these  goals,  a  set  of  software  standards  was  defined  both  to  design  the  modules  and  to  guide  the 
codification  of  the  resulting  algorithms.  While  these  concepts  were  required  for  all  ASTROS  development 
efforts,  they  are  not  required  for  the  developer  of  a  new  ASTROS  module  that  is  outside  the  scope  of  the 
official  code.  Many  of  these  concepts,  however,  provide  useful  guidelines  for  all  code  development  and 
avoid  several  potential  pitfalls. 

The  most  crucial  concept  is  that  of  modularity.  From  the  programmer’s  point  of  view,  this  means 
that  the  mechanisms  by  which  the  module  communicates  with  other  modules  and  with  the  executive  are 
limited  to  maximize  the  independence  of  each  module.  For  example,  the  interdependence  of  modules  is 
reduced  by  communicating  with  data  structures  (e.g.,  relations,  matrices,  and  unstructured  entities)  that 
reside  on  the  database  rather  than  in  memory.  Further  independence  is  achieved  by  n.sing  dummy 
arguments  to  communicate  between  program  units  within  a  module  and  by  avoiding  the  use  of  pathologi¬ 
cal  communications  such  as  common  blocks.  This  mechanism  of  internal  communication  is  well  suited  to 
the  DMM  for  reasons  of  both  modularity  and  simplicity.  The  DMM  also  eases  the  programmer’s  task  in 
ensuring  modularity  by  preventing  the  passage  between  modules  of  those  data  stored  in  open  core  blocks. 
The  programmer  is  also  given  some  additional  debugging  tools  to  ensure  that  the  modularity  has  been 
maintained. 

Modularity  and  maintainability  may  be  further  enhanced  by  recognizing  that  there  are  several 
distinct  groups  of  code  in  ASTROS.  These  are  the  system  level  modules,  the  engineering  application 
modules,  the  apphcation  utihty  modules,  the  large  matrix  utility  modvdes,  and  the  database/memory 
manager  utility  modules.  AH  these  modules  comprising  the  current  system  are  documented  in  Sections  3 
through  8.  Most  important  from  the  apphcation  programmer’s  point  of  view  are  the  utility  modules.  The 
programmer  should  become  famihar  with  the  utihty  modules  so  that  optimal  use  can  be  made  of  the 
existing  ASTROS  software.  By  using  the  existmg  utihties  whenever  possible,  needless  duphcation  of  code 
is  avoided  and  the  maintainability  is  enhanced.  Also,  the  abhity  to  read  the  code  is  improved  since  the 
limited  number  of  utilities  are  easily  recognized  by  another  programmer  and  no  time  need  be  spent  in 
determining  the  function  of  a  duphcate  code  block. 

Machine  transportability  was  a  major  consideration  in  the  development  of  the  ASTROS  system. 
This  requirement  is  not  as  critical  for  the  apphcation  programmer  who  wants  to  install  a  special  ptupose 
module  into  the  ASTROS  system.  It  may  be  useful,  however,  to  foUow  some  basic  guidelines,  if  for  no 
other  reason  than  the  module’s  ofif-site  utihty.  The  basic  guideline  to  foUow  is  that  all  code  be  developed 
using  the  FORTRAN  language  adhering  to  the  ANSI  X3.9-1978  standard.  This  sissures  proper  compila¬ 
tion  and  execution  over  a  wide  variety  of  computers  and  operating  systems.  Common  nonstandard 
features  such  as  certain  file  operations,  FORTRAN  enhancements  and  the  use  of  site  specific  utility 
hbraries  should  be  avoided  to  maintain  the  transportabihty  of  the  resultant  system.  It  may  be  the  case 
that  the  enhanced  or  site  specific  featinres  are  required  in  the  new  module.  If  so,  the  transportabihty  of 
the  system  cannot  be  maintained:  the  programmer  should  give  serious  consideration  to  the  ramifications 
of  this  loss  before  committing  to  a  nonstandard  piece  of  code. 

In  the  author’s  experience,  the  most  common  problems  with  machine  dependencies  (aside  from 
those  already  isolated)  come  from  code  developed  using  nonstandard  FORTRAN  enhancements.  Often, 
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the  resident  FORTRAN  compiler  does  not  identify  extensions  to  the  standard  and  inexperienced  pro¬ 
grammers  do  not  recognize  that  their  code  is  nonstandard.  A  brief  list  of  enhancements  that  are  fre¬ 
quently  seen  and  that  should  be  avoided  is; 

1.  The  use  of  hollerith  data  outside  DATA  statements  and  FORMAT  statements. 

2.  Special  OPEN  and  CLOSE  parameters  and  other  file  operations.  Unless  absolutely  necessary, 
I/O  should  be  limited  to  the  database  and  the  standard  output  file  or  punch  file. 

3.  DO-WHILE  and  DO-UNTIL  looping  constructs  —  these  can  and  should  be  emulated  using 
standard  FORTRAN. 

4.  Nonstandard  variable  names:  in  excess  of  6  characters  in  length  or  containing  nonstandard 
characters. 

5.  CHARACTER  and  non-CHARACTER  data  within  a  single  named  COMMON  block  —  many 
compilers  allow  this  without  warning  but  it  is  nonstandard  and  can  cause  problems. 

6.  Very  large  or  veiy  small  constants  often  create  problems  in  that  the  range  of  legal  real  numbers 
is  highly  machine  dependent. 

7.  Nonstandard  type  declarations:  common  examples  are  DOUBLE  PRECISION  COMPLEX, 
REAL*16,  and  INTEGER*!. 


1 0.2.  DYNAMIC  MEMORY  MANAGEMENT 

ASTROS  has  a  powerful  and  flexible  Dynamic  Memory  Manager  (DMM)  which  allows  the  pro¬ 
grammer  to  allocate  blocks  of  memory  of  a  variable  size  determined  at  execution  time.  Various  groups  of 
memory,  each  containing  one  or  more  blocks,  may  be  allocated  and  assigned  names.  The  DMM  then 
returns  pointers  to  the  various  blocks  relative  to  a  single  named  common  block  unique  to  each  module. 
All  but  the  smallest  local  arrays  used  within  a  subroutine  should  use  the  DMM.  There  are  three  major 
reasons  for  this:  (1)  it  eliminates  the  need  to  make  a  priori  judgements  about  the  size  of  arrays  to 
allocate,  thus  eluninating  or  reducing  the  problem  size  restrictions  (2)  the  DMM  can  automatically  take 
into  account  the  precision  of  the  data  and  (3)  the  resultant  code  is  more  likely  to  be  modular  since  the 
DMM  promotes  the  modular  use  of  memory  resources.  These  important  application  utilities  are  docu¬ 
mented  in  Section  8.3. 

Memory  can  be  allocated  or  released  at  any  point  in  the  code,  allowing  the  programmer  to  make 
optimal  use  of  system  resources.  Typically,  however,  memory  requests  are  made  in  high  level  routines 
within  a  module,  and  the  resultant  memory  block  addresses  are  passed  to  the  subroutines  which  make 
use  of  them.  In  this  manner,  the  lower  level  routines  may  be  coded  in  an  open-ended,  modular  fashion 
with  no  need  to  keep  track  of  memory  block  pointers.  This  approach  is  ideal  when  incorporating  other 
codes  (which  do  not  make  use  of  dynamic  memory  management)  into  the  ASTROS  system.  In  these  cases, 
a  top  level  driver  routine  for  the  new  module  may  isolate  all  requests  to  allocate  and  subsequently  free 
memory  used  within  the  module.  By  passing  the  starting  address  of  the  memory  block  to  the  lower  level 
routines,  the  original  array  variables  may  often  be  preserved  (thus  avoiding  extensive  recoding)  and  any 
fixed  dimensions  for  this  array  are  removed.  An  equally  effective  technique  is  to  pass  the  base  core 
address  (the  address  passed  to  the  MMBASE  utility)  to  the  lower  level  routines.  This  method  has  the 
added  benefit  of  eliminating  the  open  core  COMMON  block  from  the  lower  level  routines. 
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1 0.3.  CADDB  APPLICATION  INTERFACE 


CADDB  is  the  basis  of  the  majority  of  I/O  activity  within  ASTROS.  All  of  the  input  data, 
transitional  results  and  answers  are  placed  into  entities  on  this  database.  Modules  and  subroutines  are 
free  to  draw  from  the  existing  entities  and  to  create  new  entities,  both  for  archival  purposes  and  to  use  as 
scratch  space  during  execution.  The  CADDB  applications  interface  has  been  designed  to  interact  effec¬ 
tively  with  the  DMM.  For  example,  all  entities  include  descriptions  of  the  amount  of  data  which  they 
contain  so  that  the  proper  memory  block  request  can  be  made  prior  to  retrieving  the  data.  Techniques 
found  in  older  systems,  such  as  in  NASTRAN,  in  which  all  available  memory  is  allocated  prior  to  entering 
the  module,  should  not  be  used,  although  they  may  be  emulated  using  the  ASTROS  DMM. 

When  incorporating  other  codes  into  the  ASTROS  system,  it  is  desirable  to  conform  to  the 
ASTROS  requirement  that  all  input  come  from  the  input  data  stream  and  subsequently  be  available  on 
the  database.  Although  user  input  to  a  module  can  come  from  the  MAPOL  sequence  or  any  external  file, 
more  typically,  input  will  come  from  bulk  data  entries  which  are  loaded  at  run  time  into  corresponding 
database  relational  entities.  The  use  of  external  files  should  be  minimized  because  of  the  strongly 
machine  dependent  nature  of  the  I/O  interface  and  potential  conflicts  with  the  existing  I/O  interface. 
Hence,  FORTRAN  READ  statements  should  not  appear  in  any  of  the  new  modules.  Instead,  a  suitable 
set  of  database  entities  should  be  designed  such  that  existing  READ  statements  can  be  replaced  with 
queries  to  the  database.  As  with  the  calls  to  the  memory  manager,  described  in  Section  8.3,  a  common 
practice  is  to  group  the  database  calls  in  a  high  level  or  driver  routine  in  a  module  and  then  pass  the 
retrieved  data  to  the  lower  level  routines  through  parameter  lists.  This  helps  to  keep  the  engineering 
routines  free  of  the  otherwise  extraneous  clutter  which  can  result  from  a  series  of  memory  manager  and 
database  requests.  This  method  is  most  effective  when  installing  existmg  code  as  an  ASTROS  module. 

Three  types  of  database  entities  (relational,  matrix,  and  unstructured)  are  used  in  ASTROS. 
Entities  derived  from  the  bulk  data  wiU  typically  be  relational  or  matrix,  while  entities  which  are  written 
in  an  engineering  module  can  be  of  any  type.  Regardless  of  the  type  of  entity ,  it  must  be  opened  with  the 
DBOPEN  database  utility  routine  before  any  I/O  operations  are  performed,  and,  when  no  more  I/O  will 
be  done  on  the  entity  in  the  ciurent  module,  it  must  be  closed  with  the  DBCLOS  routine.  Each  entity 
t3q)e  has  its  own  suite  of  database  management  utilities,  and  these  are  dociunented  in  Section  8.  The 
CADDB  application  programming  interface  is  fairly  complex  and  consists  of  a  large  number  of  individual 
utilities  which  may  prove  daunting  to  the  novice  ASTROS  programmer  this  is  especially  true  of  ihe 
matrix  entity  access  methods.  Section  8  is  full  of  simple  examples,  however,  which  indicate  the  range  of 
capability  of  the  CADDB  interface.  The  reader  is  strongly  encouraged  to  study  Section  8  and  to  write 
some  simple  routines  to  practice  the  interface.  The  experienced  ASTROS  programmer  will  find  that  the 
CADDB  interface  greatly  simplifies  the  task  of  writing  almost  any  piece  of  ASTROS  software. 


1 0.4.  CODING  PRACTICE  —  THE  ASTROS  INTERFACE 

The  architecture  of  the  ASTROS  system  lends  itself  to  enhancements.  Nevertheless,  the  addition 
of  new  code  is  not  a  trivial  task,  and  is  further  complicated  by  the  flexibility  of  the  MAPOL  language  to 
handle  optional  arguments,  functions  and  subroutines,  procedures  and  looping  instructions,  all  of  which 
play  an  important  role  in  designing  the  module  interface.  The  programmer  is  left  with  the  difficult  task  of 
deciding  how  best  to  accomphsh  the  interface  in  an  environment  so  flexible  that  no  clues  are  given  at  to 
how  best  to  proceed.  All  that  can  be  suggested  is  that  existing  modules  be  used  as  examples  and  that 
experience  will  shed  light  on  the  best  methods  to  access  modules. 

Typically  addition  of  new  code  is  accomplished  by  adding  a  MAPOL  callable  module.  This  will  be 
accompanied  by  the  modification  of  several  of  the  SYSGEN  input  files  used  for  generating  the  ASTROS 
System  database.  These  files  are  (1)  the  module  definition  file  (MODDEF),  (2)  the  relational  schema  file 
(RELATION),  (3)  the  module  control  sequence  (MAPOL),  (4)  the  bulk  data  template  file  (TEMPLATE), 
and  (5)  the  error  message  file  (SERRMSG).  The  capitalized,  parenthetical  words  represent  typical  root 
names  of  these  files  for  ease  of  reference.  The  format  for  each  of  these  files  is  specified  in  Section  3.2.  The 
motivation  behind  each  modification  is  described  in  the  following  notes: 

MODDEF  must  be  modified  to  define  the  new  module  to  the  system  so  that  it  may  be  called  from 
the  MAPOL  sequence.  If  the  module  performs  a  function  that  may  be  generically  applied  to  more 
than  one  database  entity  of  the  same  type  and  form,  it  may  then  be  desirable  to  include,  with  the 
module  definition,  calling  argument  definitions  to  pass  in  the  names  of  the  entities  to  be  used. 

RELATION  must  be  updated  to  define  the  relational  schemata  of  all  the  new  relational  database 
entities  in  the  module,  including  those  associated  with  new  bulk  data  entries.  Relational  sche¬ 
mata  can  be  defined  instead  through  application  calls  to  CADDB  within  the  new  module:  how¬ 
ever,  this  is  cumbersome  and  may  lead  to  problems  when  the  module  is  executed  more  than  once 
or  not  at  all.  Therefore,  all  relations  should  be  defined  through  the  SYSGEN  RELATION  file  and 
aU  intermodular  entities  should  be  created  by  the  executive  (through  a  MAPOL  declaration). 

MAPOL  must  be  changed  if  the  new  module  is  to  be  a  part  of  the  standard  module  control  se¬ 
quence.  Otherwise,  it  will  be  necessary  to  include  a  new  MAPOL  sequence  or  an  EDIT  of  the 
standard  sequence  in  the  input  data  file  of  every  ASTROS  job  which  will  use  the  new  module.  In 
either  case,  the  names  and  types  of  all  new  (and  old)  database  entities  which  will  be  opened  dur¬ 
ing  a  run  must  be  declared  in  the  MAPOL  sequence  which  is  used.  However,  a  programmer 
should  not  modify  the  standard  sequence  xmless  he/she  is  very  familiar  with  the  ASTROS  sys¬ 
tem.  The  MAPOL  EDIT  feature  provides  the  necessary  capabilities  and  avoids  possible  corrup¬ 
tion  of  the  standard  sequence. 

TEMPLATE  must  be  revised  to  define  new  bulk  data  entries  if  the  module  requires  any  input 
data  that  cannot  be  supplied  by  the  current  bulk  data  entries  and/or  other  engineering  modules. 
Every  template  definition  must  have  a  corresponding  entity  definition  to  which  the  data  are 
loaded. 

SERRMSG  must  be  updated  to  include  any  new  error  message  texts  that  are  to  be  accessed 
through  the  error  message  output  utility,  UTMWRT,  documented  in  Section  6.  Unless  the  module 
is  to  be  made  a  permanent  part  of  the  ASTROS  system,  it  may  be  preferable  to  write  informa- 
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tional  and  error  messages  directly  to  the  output  file.  As  mentioned  in  the  following,  the  \init  num¬ 
ber  of  the  output  file  can  be  found  in  the  /UNITS/  common  block. 

If  communication  is  desired  between  subroutines  within  the  new  module,  it  is  suggested  that 
common  blocks  be  avoided,  especially  common  blocks  containing  fixed  length  arrays  which  place  hard 
coded  limits  on  problem  size.  Use  of  common  blocks  tends  to  obscure  a  module’s  structure  and  to  reduce 
readability  and  maintainability.  Instead,  variables  and  arrays  should  be  passed  through  the  subroutines 
calling  hsts.  In  cases  where  an  older  code  has  made  prolific  use  of  memory  pointers  (as  in  COSMIC/NAS- 
TRAN),  there  may  be  so  many  pointers  to  be  passed  that  it  is  more  convenient  to  place  them  within  a 
common  block  than  to  pass  them  through  argument  lists.  This  approach  can  be  justified  by  the  fact  that 
these  pointers  are  set  once  in  an  upper  level  routine  in  the  module  and  then  never  modified.  If  new 
common  blocks  are  introduced,  care  must  be  taken  to  ensure  that  unique  common  block  names  are  used. 


For  communication  between  modules,  the  database  must  be  used.  Common  blocks  must  never  be 
used  for  intermodular  communication  except  for  certain  system  level  common  blocks.  The  exceptira  to 
the  prohibition  of  common  blocks  is  for  common  blocks  which  contain  system  p^ameters,  such  as 
FORTRAN  I/O  tmit  numbers,  and  mathematical  constants,  such  as  n.  These  quantities  are  so  pervasive 
that  requiring  that  they  be  passed  through  argument  lists  could  be  unduly  burdensome.  The  following 
system  level  common  blocks  are  used  throughout  ASTROS: 


COMMON/ CONDAS / 

PI,  TWOPI,  RADEG,  DEGRA 

1 

FORPI2 

COMMON /CONAD/ 

DPI,  DTWOPI,  DRADEG,  DDEGRA, 

1 

D4PISQ 

COMMON/UNITS/ 

lUNIT  (15) 

COMMON/OUTPTl/ 

NLPP,  MAXLIN,  PAGENO,  LINE, 

1 

TOTLIN 

COMMON/ OUTPT2/ 

TITLE,  SUBTIT,  LABEL,  HEADl, 

1 

HEAD2 ,  HEAD3 

/CONDAS/  and  /CONDAD/  are  set  in  block  data  routine  ASTRBD  and  contain  single  and  double 
precision  versions,  respectively,  of  trigonometric  quantities.  These  are  n  ,  2  n  ,  the  multiplier  firom 
radians  to  degrees,  the  multiplier  from  degrees  to  radians,  and  4  /UNITS/,  /OUTPTl/,  and  /OUTPT2/ 
are  set  and  documented  in  block  data  routine  XXBD.  /UNITS/  contains  the  FORTRAN  file  unit  n^bers 
for  ASTROS  I/O.  lUNIT(l)  is  the  ASTROS  input  file  and  IUNIT(2)  is  the  ASTROS  output  file.  /OUTPTl/ 
and  /OUTPT2/  contain  quantities  used  to  control  the  formatting  of  data  output.  These  two  common  blocks 
should  be  included  in  any  utility  module  which  uses  the  UTPAGE  apphcation  utility  module  (documented 
in  Section  6).  NLPP  represents  the  number  of  lines  per  page,  MAXLIN  is  the  maximum  number  of  output 
lines  allowed  per  ASTROS  run,  PAGENO  is  the  current  page  number,  LINE  is  the  current  line  number, 
TOTLIN  is  the  total  number  of  lines  output  so  far,  and  TITLE,  SUBTIT,  LABEL,  HEADl,  HEAD2,  and 
HEADS  are  the  title,  subtitle,  lable,  and  headers  which  will  be  output  in  that  order  at  the  top  of  each 
page.  Of  these,  LINE,  HEADl,  HEAD2,  and  HEADS  are  the  only  variables  that  should  be  assigned  by  a 


routine  which  utilizes  UTPAGE. 
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